# Connect a custom domain

> Source: /api-reference/partner/explorer/custom-domains/create
> Registers a domain owned by your organization, one of its brands, or one of its venues. The domain starts unverified; drive DNS verification with an Entri session, then poll or force a recheck.
> Full spec: https://docs.journey.com/openapi/partner.v1.json

## `POST /v1/partner/custom-domains`

```json
{
  "description": "Registers a domain owned by your organization, one of its brands, or one of its venues. The domain starts unverified; drive DNS verification with an Entri session, then poll or force a recheck.",
  "operationId": "customDomainsPartner_create",
  "parameters": [],
  "requestBody": {
    "content": {
      "application/json": {
        "schema": {
          "$ref": "#/components/schemas/CreatePartnerCustomDomainRequest"
        }
      }
    },
    "required": true
  },
  "responses": {
    "201": {
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/PartnerCustomDomainResponse"
          }
        }
      },
      "description": "The newly connected domain, pending verification."
    },
    "400": {
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/PartnerErrorResponse"
          }
        }
      },
      "description": "Request validation failed. `errors` lists the offending fields."
    },
    "401": {
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/PartnerErrorResponse"
          }
        }
      },
      "description": "No usable credential. Send `Authorization: Bearer <jwt>` or `X-API-Key: jny_...`."
    },
    "403": {
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/PartnerErrorResponse"
          }
        }
      },
      "description": "The credential authenticated but lacks the scopes in `x-required-scopes`, or the resource belongs to another organization."
    },
    "409": {
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/PartnerErrorResponse"
          }
        }
      },
      "description": "The request conflicts with the current state of the resource."
    }
  },
  "security": [
    {
      "partnerBearer": []
    },
    {
      "partnerApiKey": []
    }
  ],
  "summary": "Connect a custom domain",
  "tags": [
    "partner/custom-domains"
  ],
  "x-required-scopes": [
    [
      "partner:custom-domains:manage"
    ]
  ]
}
```