# CustomDomain Connections API

**Canonical:** https://apis.io/apis/customdomain-ai/customdomain-ai-connections-api/  
**Provider:** CustomDomain — https://apis.io/providers/customdomain-ai/  
**Base URL:** https://api.customdomain.ai/v1  
**Documentation:** https://docs.customdomain.ai/docs/api-reference

CustomDomain Connections API is one of 25 APIs that [CustomDomain](https://apis.io/providers/customdomain-ai/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 1 JSON Schema definition. Tagged areas include Connections. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 1 JSON Schema.

The connect pipeline for one customer domain, across all four rails.

## Operations (31)

| Method | Path | Summary |
|---|---|---|
| POST | `/connections` | Create a domain connection (idempotent per app + domain) |
| GET | `/connections` | List connections |
| GET | `/connections:count` | Count the tenant's connections (no rows) |
| GET | `/connections/{id}` | Get a connection with its authoritative record set |
| PATCH | `/connections/{id}` | Change a domain's client name, www redirect or forwarding |
| DELETE | `/connections/{id}` | Remove a domain, removing or keeping the DNS records we added |
| GET | `/connections/{id}/removal` | What removing a domain would do with its DNS records |
| GET | `/connections/{id}/certificate` | The domain's certificate, its renewal and its history |
| GET | `/connections/{id}/services` | The CustomDomain™ services the domain uses |
| GET | `/connections/{id}/events` | The domain's timeline |
| GET | `/services:summary` | How many domains use each service, per application and workspace |
| GET | `/connections:lookup` | Find your connection for a domain |
| POST | `/connections/{id}:disconnect` | Remove a domain, optionally authorizing the record removal once with a key |
| GET | `/connections/{id}/diagnose` | What public DNS shows for each record, and what is left to do |
| GET | `/connections/{id}/records` | Authoritative desired DNS record set for a connection |
| PUT | `/connections/{id}/records` | Supply the connection's desired DNS record set |
| PUT | `/connections/{id}/end-user-email` | Leave the end user's email address on a connection |
| DELETE | `/connections/{id}/grant` | Turn managed mode OFF without disconnecting |
| POST | `/connections/{id}/apply` | Write a connection's records through the customer's provider (BYO token, used… |
| POST | `/connections/{id}:reapply` | Re-apply a managed connection's desired records (async one-click, no re-consent) |
| POST | `/connections/{id}:recheck` | Check a connection's DNS now, and report what public DNS answered |
| POST | `/connections/{id}:retarget` | Move a domain to its application's current routing, or back to the edge |
| POST | `/connections/{id}/oauth:start` | Begin the sign-in to the DNS provider for a connection |
| GET | `/connect/oauth/callback` | OAuth redirect target (public; authenticated by the signed state) |
| GET | `/connect/dc/callback` | Async one-click setup redirect target (public; authenticated by the signed… |
| GET | `/connect/dc/return/{state}` | One-click sync return (public; authenticated by the signed state) |
| GET | `/connect/dc/return` | One-click sync return with the state as a query parameter |
| POST | `/connections/{id}/domainconnect:start` | Build the one-click apply URL (sync) or start the managed async rail |
| POST | `/connections/{id}/route53-role:start` | Start connecting a Route 53 domain through a limited IAM role instead of an… |
| POST | `/connections/{id}/route53-role:complete` | Verify the customer's Route 53 access role and write the connection's records… |
| POST | `/connections:bulk` | Create connections for a set of domains in one call |

## Machine-readable artifacts (3)

- **OpenAPI** — https://artifacts.apis.io/customdomain-ai/openapi/customdomain-ai-connections-api-openapi.yml
- **Documentation** — https://docs.customdomain.ai/docs/api-reference
- **JSONSchema** — https://artifacts.apis.io/customdomain-ai/json-schema/customdomain-ai-connection-schema.json

## Other CustomDomain APIs (12)

- [CustomDomain MCP Server](https://apis.io/apis/customdomain-ai/mcp-server/)
- [CustomDomain Agents API](https://apis.io/apis/customdomain-ai/customdomain-ai-agents-api/)
- [CustomDomain Analytics API](https://apis.io/apis/customdomain-ai/customdomain-ai-analytics-api/)
- [CustomDomain Applications API](https://apis.io/apis/customdomain-ai/customdomain-ai-applications-api/)
- [CustomDomain Billing API](https://apis.io/apis/customdomain-ai/customdomain-ai-billing-api/)
- [CustomDomain Cloud browser API](https://apis.io/apis/customdomain-ai/customdomain-ai-cloud-browser-api/)
- [CustomDomain Connect API](https://apis.io/apis/customdomain-ai/customdomain-ai-connect-api/)
- [CustomDomain Domains API](https://apis.io/apis/customdomain-ai/customdomain-ai-domains-api/)
- [CustomDomain Enterprise API](https://apis.io/apis/customdomain-ai/customdomain-ai-enterprise-api/)
- [CustomDomain Managed DNS API](https://apis.io/apis/customdomain-ai/customdomain-ai-managed-dns-api/)
- [CustomDomain Members API](https://apis.io/apis/customdomain-ai/customdomain-ai-members-api/)
- [CustomDomain Meta API](https://apis.io/apis/customdomain-ai/customdomain-ai-meta-api/)

## Tags

Connections

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/customdomain-ai/customdomain-ai-connections-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/customdomain-ai/.