---
descriptions:
  organization:
    self: 'The [Organization](/reference/organization) object.'
    object: Distinguishes the Organization object.
    id: Unique identifier of the Organization.
    name: >-
      A descriptive name for the Organization. This field does not need to be
      unique.
    domains: 'List of [Organization Domains](/reference/domain-verification).'
    stripe_customer_id: |
      The Stripe customer ID associated with this organization.
    external_id: The external ID of the Organization.
    metadata: >-
      Object containing [metadata](/authkit/metadata) key/value pairs associated
      with the Organization.
    created_at: The timestamp when the Organization was last created.
    updated_at: The timestamp when the Organization was last updated.
  domain_data:
    domain: >-
      The domain to be added to the organization. This should be a domain owned
      by the organization, and not a common consumer domain like `gmail.com`.
    state: >
      The verification state of the domain.


      Use the `"verified"` state to indicate that the organization has confirmed

      to you that they own this domain. A [verified

      domain](/authkit/domain-verification) may belong to multiple

      organizations but only a single organization can include the domain in its

      [Domain Policy](/authkit/organization-policies/domain-policy),

      which has the potential to affect authentication policy across your

      application.


      Use the `"pending"` state to indicate that the organization hasn’t
      verified

      ownership of the domain. You can use [Domain
      Verification](/domain-verification)

      to allow an organization admin to verify the domain via Admin Portal.
reference:
  curl:
    - url: /reference/organization
      key: organization
      id: organization
      title: organization
      properties:
        - key: object
          type: '"organization"'
          description: (organization.object)
        - key: id
          type: string
          description: (organization.id)
        - key: name
          type: string
          description: (organization.name)
        - key: created_at
          type: string
          description: (organization.created_at)
        - key: updated_at
          type: string
          description: (organization.updated_at)
        - key: domains
          type: array
          description: (organization.domains)
        - key: stripe_customer_id
          optional: true
          type: string
          description: (organization.stripe_customer_id)
        - key: external_id
          optional: true
          type: string
          description: (organization.external_id)
        - key: metadata
          optional: true
          type: object
          description: (organization.metadata)
  js:
    - url: /reference/organization
      key: Organization
      id: organization
      title: interface Organization
      properties:
        - key: object
          type: '"organization"'
          description: (organization.object)
        - key: id
          type: string
          description: (organization.id)
        - key: name
          type: string
          description: (organization.name)
        - key: createdAt
          type: string
          description: (organization.created_at)
        - key: updatedAt
          type: string
          description: (organization.updated_at)
        - key: domains
          type: 'OrganizationDomain[]'
          description: (organization.domains)
        - key: stripeCustomerId
          optional: true
          type: string
          description: (organization.stripe_customer_id)
        - key: externalId
          optional: true
          type: string
          description: (organization.external_id)
        - key: metadata
          optional: true
          type: object
          description: (organization.metadata)
  go:
    - url: /reference/organization
      key: Organization
      id: organization
      title: organizations.Organization
      properties:
        - key: ID
          type: string
          description: (organization.id)
        - key: Name
          type: string
          description: (organization.name)
        - key: CreatedAt
          type: string
          description: (organization.created_at)
        - key: UpdatedAt
          type: string
          description: (organization.updated_at)
        - key: Domains
          type: '[]organizations.OrganizationDomain'
          description: (organization.domains)
  java:
    - url: /reference/organization
      key: Organization
      id: organization
      title: class Organization
      properties:
        - key: obj
          type: '"organization"'
          description: (organization.object)
        - key: id
          type: String
          description: (organization.id)
        - key: name
          type: String
          description: (organization.name)
        - key: domains
          type: List<OrganizationDomain>
          description: (organization.domains)
        - key: createdAt
          type: String
          description: (organization.created_at)
        - key: updatedAt
          type: String
          description: (organization.updated_at)
  python:
    - url: /reference/organization
      key: Organization
      id: organization
      title: Organization
      properties:
        - key: object
          type: '"organization"'
          description: (organization.object)
        - key: id
          type: str
          description: (organization.id)
        - key: name
          type: str
          description: (organization.name)
        - key: created_at
          type: str
          description: (organization.created_at)
        - key: updated_at
          type: str
          description: (organization.updated_at)
        - key: domains
          type: 'Sequence[OrganizationDomain]'
          description: (organization.domains)
  ruby:
    - url: /reference/organization
      key: Organization
      id: organization
      title: class Organization
      properties:
        - key: object
          type: '"organization"'
          description: (organization.object)
        - key: id
          type: String
          description: (organization.id)
        - key: name
          type: String
          description: (organization.name)
        - key: created_at
          type: String
          description: (organization.created_at)
        - key: updated_at
          type: String
          description: (organization.updated_at)
        - key: domains
          type: 'Array[Hash]'
          description: (organization.domains)
  php:
    - url: /reference/organization
      id: organization
      key: Organization
      title: WorkOS\Resource\Organization
      properties:
        - key: object
          type: '"organization"'
          description: (organization.object)
        - key: id
          type: string
          description: (organization.id)
        - key: name
          type: string
          description: (organization.name)
        - key: domains
          type: 'array[]'
          description: (organization.domains)
        - key: createdAt
          type: string
          description: (organization.created_at)
        - key: updatedAt
          type: string
          description: (organization.updated_at)
  dotnet:
    - url: /reference/organization
      key: Organization
      id: organization
      title: class Organization
      properties:
        - key: Object
          type: '"organization"'
          description: (organization.object)
        - key: Id
          type: string
          description: (organization.id)
        - key: Name
          type: string
          description: (organization.name)
        - key: Domains
          type: 'OrganizationDomain[]'
          description: (organization.domains)
        - key: CreatedAt
          type: string
          description: (organization.created_at)
        - key: UpdatedAt
          type: string
          description: (organization.updated_at)
originalPath: .tmp-workos-clone/packages/docs/content/reference/organization/index.mdx
---

# Organization

An Organization is a top-level resource in WorkOS. Each Connection, Directory, and Audit Trail Event belongs to an Organization. An Organization will usually represent one of your customers. There is no limit to the number of organizations you can create in WorkOS.

<CodeBlock
  title="Example Organization"
  file="organization"
  referenceId="organization"
/>