> For the complete documentation index, see [llms.txt](https://docs.aurinko.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.aurinko.io/dynamic-api/adding-a-custom-service-type.md).

# Adding a Custom Service Type

Define custom Aurinko service types to connect private APIs and internal services to Aurinko. Access custom services through the Dynamic API and Aurinko Sync.

Not all APIs are public or intended for broad platform ecosystems like Salesforce, HubSpot, or Microsoft Dynamics. Many systems rely on private, internal APIs that need to remain secure and restricted to internal workflows.

To support these use cases and further advance Aurinko as a [capability platform](https://www.aurinko.io/blog/the-case-for-a-capability-platform/), developers can now **add custom service types** in Aurinko.

Inspired by intuitive API builders like Bubble’s API connector, this developer UI allows you to define a new, custom Aurinko <mark style="color:$danger;">`serviceType`</mark> representing your proprietary backends or internal microservices. Once created, your custom service can immediately be queried and managed through the Dynamic API across your team's applications.

### Why Define a Custom Service Type in Aurinko?

***

Wrapping your private internal services into a custom Aurinko service type turns disparate backend systems into standardized, enterprise-grade infrastructure:

* **Canonical Access via Dynamic API:** Standardize how internal services present data. Dynamic API normalizes your custom endpoints behind unified RESTful patterns, ensuring clean object mapping and consistent response structures across all applications.
* **Streamlined Brightsync Activation:** Instead of building complex custom sync pipelines from scratch, defining your internal schema under a custom service type allows new teams to rapidly map their data models to **Aurinko Sync (Brightsync)**. This instantly activates pre-built activity capture, calendar, and contact synchronization capabilities.
* **Built-in Authorization & Token Management:** Offload access control. Your custom service automatically hooks into Aurinko's unified authentication infrastructure, handling token management, and session validation without requiring custom auth middleware.
* **Out-of-the-Box Rate Limiting & Throttling:** Guard internal backend services against traffic spikes and accidental infinite loops. Aurinko enforces configurable rate limits and request queuing at the gateway layer before traffic hits your servers.
* **Problematic Request & Endpoint Capture:** Gain instant operational visibility without digging through server logs. When a call fails, the developer UI automatically captures and displays the last problematic request, payload, giving your team immediate insight for fast root-cause analysis.
* **Automated Webhooks & Event Dispatching:** Avoid building bespoke event-processing logic. Aurinko standardizes event subscriptions and webhook delivery for updates originating from your internal services.
* **Unified Developer Experience:** Internal engineering teams use a single, familiar developer portal, data model, and SDK setup—whether they are interacting with third-party SaaS APIs or your internal proprietary tools.

{% hint style="info" %}
**Note:** The user interface for adding custom service types is currently in an early preview stage. Features, layout, and visual elements will evolve rapidly based on user feedback.
{% endhint %}