Organization Domains

Create a new organization domain.

Changed on

Creates a new organization domain. By default the domain is verified, but can be optionally set to unverified.

post/organizations/{organization_id}/domains

Request

  • Base URL: https://api.clerk.com/v1
  • URL: https://api.clerk.com/v1/organizations/{organization_id}/domains
  • Auth: HTTP bearer

Path parameters

organization_idstring required

The ID of the organization where the new domain will be created.

Request body

namestring

The name of the new domain

enrollment_modestring

The enrollment_mode for the new domain. This can be automatic_invitation, automatic_suggestion, manual_invitation or enterprise_sso

verifiedboolean nullable

The status of domain's verification. Defaults to true

Response

An organization domain

object'organization_domain' required

String representing the object's type. Objects of the same type share the same value. Always organization_domain

idstring required

Unique identifier for the organization domain

organization_idstring required

Unique identifier for the organization

namestring required

Name of the organization domain

enrollment_mode'manual_invitation' | 'automatic_invitation' | 'automatic_suggestion' | 'enterprise_sso' required

Mode of enrollment for the domain

affiliation_email_addressstring nullable required

Affiliation email address for the domain, if available.

total_pending_invitationsinteger required

Total number of pending invitations associated with this domain

total_pending_suggestionsinteger required

Total number of pending suggestions associated with this domain

created_atinteger required

Unix timestamp when the domain was created

updated_atinteger required

Unix timestamp of the last update to the domain

Changes

  • 2025-11-100322db7bfc1bRevision changes
    • warning

      added the new enterprise_sso enum value to the response property for the response status

  • 2025-11-10e3f2b3a1c567Revision changes
    • info

      response property verification deprecated

    • info

      removed the unverified enum value from the ///// response property for the response status

    • info

      removed the verified enum value from the ///// response property for the response status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property ///// to the response with the status