Journey Docs
Partner API ExplorerCustom Domains

Mint an Entri DNS session

Required scopepartner:custom-domains:manage
POST
/v1/partner/custom-domains/{externalId}/entri-session

Returns a short-lived Entri configuration the browser hands to the Entri widget so the domain owner can apply the DNS records. Human-in-the-loop by design.

Authorization

headerAuthorizationBearer <token>

WorkOS access token (JWT) for a user who is a member of the partner organization. The organization the request is scoped to is taken from the token, not from a header or query parameter.

Only a JWT is accepted in this header. A Journey jny_ API key sent as a bearer token is rejected with 401 Invalid or expired token; send it in X-API-Key instead.

WorkOS organization API keys are not accepted yet.

Path Parameters

externalId*string

External custom domain id.

Response Body

An Entri session for the domain.

application/json
  1. response
applicationId*string
authToken*string
curl -X POST 'https://api-prd.cf.journey.com/v1/partner/custom-domains/string/entri-session'
{  "applicationId": "string",  "authToken": "string"}