---
descriptions:
  organization_domain:
    self: 'The [organization domain](/reference/domain-verification) object.'
    object: Distinguishes the organization domain object.
    id: Unique identifier of the organization domain.
    organization_id: ID of the parent Organization.
    state: Verification state of the domain.
    domain: Domain for the organization domain.
    verification_strategy: Strategy used to verify the domain
    verification_token: validation token to be used in DNS TXT record.
reference:
  curl:
    - url: /reference/domain-verification
      key: organization_domain
      id: organization-domain
      properties:
        - key: object
          type: '"organization_domain"'
          description: (organization_domain.object)
        - key: id
          type: string
          description: (organization_domain.id)
        - key: organization_id
          type: string
          description: (organization_domain.organization_id)
        - key: domain
          type: string
          description: (organization_domain.domain)
        - key: state
          type: |
            "pending" | "verified" | "failed"
          description: (organization_domain.state)
        - key: verificationStrategy
          type: |
            "dns" | "manual"
          description: (organization_domain.verification_strategy)
        - key: verificationToken
          type: string
          description: (organization_domain.verification_token)
  js:
    - url: /reference/domain-verification
      key: OrganizationDomain
      title: interface OrganizationDomain
      id: organization-domain
      properties:
        - key: object
          type: '"organization_domain"'
          description: (organization_domain.object)
        - key: id
          type: string
          description: (organization_domain.id)
        - key: organizationId
          type: string
          description: (organization_domain.organization_id)
        - key: domain
          type: string
          description: (organization_domain.domain)
        - key: state
          type: |
            "pending" | "verified" | "failed"
          description: (organization_domain.state)
        - key: verificationStrategy
          type: |
            "dns" | "manual"
          description: (organization_domain.verification_strategy)
        - key: verificationToken
          type: string
          description: (organization_domain.verification_token)
  go:
    - url: /reference/domain-verification
      key: OrganizationDomain
      id: organization-domain
      title: organization_domains.OrganizationDomain
      properties:
        - key: ID
          type: string
          description: (organization_domain.id)
        - key: Domain
          type: string
          description: (organization_domain.domain)
        - key: OrganizationID
          type: string
          description: (organization_domain.organization_id)
        - key: State
          type: OrganizationDomainState
          description: (organization_domain.state)
        - key: VerificationStrategy
          type: OrganizationDomainVerificationStrategy
          description: (organization_domain.verification_strategy)
        - key: VerificationToken
          type: string
          description: (organization_domain.verification_token)
  python:
    - url: /reference/domain-verification
      key: OrganizationDomain
      id: organization-domain
      title: OrganizationDomain
      properties:
        - key: object
          type: '"organization_domain"'
          description: (organization_domain.object)
        - key: id
          type: str
          description: (organization_domain.id)
        - key: organization_id
          type: str
          description: (organization_domain.organization_id)
        - key: domain
          type: str
          description: (organization_domain.domain)
        - key: state
          type: str
          description: (organization_domain.state)
        - key: verification_strategy
          type: str
          description: (organization_domain.verification_strategy)
        - key: verification_token
          type: str
          description: (organization_domain.verification_token)
originalPath: >-
  .tmp-workos-clone/packages/docs/content/reference/domain-verification/index.mdx
---

# Organization domain

An organization domain represents an [organization](/reference/organization)'s domain. Domains can be verified to assert that an organization owns the configured domain which is accomplished through DNS TXT record verification.

Organization domains can be verified manually through the Dashboard, or by setting `state: 'verified'` when adding domains via the [Organization create](/reference/organization/create) or [update](/reference/organization/update) APIs. Domains can also be verified through [a self-serve flow](/domain-verification) via the Admin Portal.
The organization that defines this domain policy exerts authentication policy control over that domain across your application.
For this reason, it is important to verify ownership of manually added domains.
Additionally, WorkOS does not allow addition of common consumer domains, like `gmail.com`.

To automatically respond to changes in the organization domains, use [organization domain events](/events/organization-domain).

<CodeBlock
  title="Example organization domain"
  file="organization-domain"
  referenceId="organization-domain"
/>