Custom Domain
API referenceConnections

Build the signed Domain Connect apply URL for a connection

POST
/connections/{id}/domainconnect:start

Rail A (Domain Connect). service_id may be omitted when a default/sole template is loaded. Returns the provider-hosted apply URL, the resolved service_id, and the discovered dc_provider name. Both a synchronous redirect and the asynchronous flow are supported.

Authorization

widgetJWT
AuthorizationBearer <token>

Short-lived widget JWT minted server-side via POST /v1/tokens. Scoped to one application (and optionally one domain).

In: header

Path Parameters

id*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/connections/string/domainconnect:start" \  -H "Content-Type: application/json" \  -d '{}'
{  "apply_url": "http://example.com",  "service_id": "string",  "dc_provider": "string"}
{  "code": "string",  "title": "string",  "details": "string"}
{  "code": "string",  "title": "string",  "details": "string"}
{  "code": "string",  "title": "string",  "details": "string"}
{  "code": "string",  "title": "string",  "details": "string"}