---
descriptions:
  domains_parameter: The domains of the Organization.
reference:
  curl:
    - key: create_organization
      type: POST
      id: create_organization
      url: /reference/organization/create
      title: /organizations
      parameters:
        - (organization.name)
        - key: domain_data
          optional: true
          type: array
          properties:
            - key: domain
              type: string
              description: (domain_data.domain)
            - key: state
              type: '"pending" | "verified"'
              description: (domain_data.state)
        - key: external_id
          optional: true
          type: string
          description: (organization.external_id)
        - key: metadata
          optional: true
          type: object
          description: (organization.metadata)
      returns:
        - (organization)
  js:
    - key: createOrganization
      id: create_organization
      url: /reference/organization/create
      title: organizations.createOrganization()
      parameters:
        - key: options
          type: object
          unwrap: true
          properties:
            - (Organization.name)
            - key: domainData
              optional: true
              type: 'object[]'
              properties:
                - key: domain
                  type: string
                  description: (domain_data.domain)
                - key: state
                  type: '"pending" | "verified"'
                  description: (domain_data.state)
            - key: externalId
              optional: true
              type: string
              description: (organization.external_id)
            - key: metadata
              optional: true
              type: object
              description: (organization.metadata)
      returns:
        - (Organization)
  go:
    - key: CreateOrganization
      id: create_organization
      url: /reference/organization/create
      title: organizations.CreateOrganization()
      parameters:
        - (ctx)
        - key: opts
          type: organizations.CreateOrganizationOpts
          expanded: true
          properties:
            - (Organization.Name)
            - key: DomainData
              optional: true
              type: '[]OrganizationDomainData'
              properties:
                - key: Domain
                  type: string
                  description: (domain_data.domain)
                - key: State
                  type: OrganizationDomainDataState
                  description: (domain_data.state)
      returns:
        - key: org
          type: organizations.Organization
          description: (organization.self)
        - (err)
  java:
    - key: createOrganization
      id: create_organization
      url: /reference/organization/create
      title: organizations.createOrganization()
      parameters:
        - key: options
          type: CreateOrganizationOptions
          expanded: true
          properties:
            - (Organization.name)
            - key: domainData
              optional: true
              type: List<OrganizationDomainDataOptions>
              properties:
                - key: domain
                  type: String
                  description: (domain_data.domain)
                - key: state
                  type: OrganizationDomainDataState
                  description: (domain_data.state)
            - key: builder()
              type: CreateOrganizationOptionsBuilder
              description: (java.builder)
      returns:
        - (Organization)
  ruby:
    - key: create_organization
      id: create_organization
      url: /reference/organization/create
      title: Organizations.create_organization()
      parameters:
        - (Organization.name)
        - key: domain_data
          optional: true
          type: 'Array[Hash]'
          properties:
            - key: domain
              type: String
              description: (domain_data.domain)
            - key: state
              type: '"pending" | "verified"'
              description: (domain_data.state)
      returns:
        - (Organization)
  python:
    - key: create_organization
      id: create_organization
      url: /reference/organization/create
      title: organizations.create_organization()
      parameters:
        - (Organization.name)
        - key: domain_data
          optional: true
          type: 'Sequence[DomainDataInput]'
          properties:
            - key: domain
              type: string
              description: (domain_data.domain)
            - key: state
              type: '"pending" | "verified"'
              description: (domain_data.state)
      returns:
        - (Organization)
  php:
    - key: createOrganization
      id: create_organization
      url: /reference/organization/create
      title: $organizations->createOrganization()
      parameters:
        - (Organization.name)
        - key: domain_data
          optional: true
          type: 'object[]'
          properties:
            - key: domain
              type: string
              description: (domain_data.domain)
            - key: state
              type: '"pending" | "verified"'
              description: (domain_data.state)
      returns:
        - (Organization)
  dotnet:
    - key: CreateOrganization
      id: create_organization
      url: /reference/organization/create
      title: organizationsService.CreateOrganization()
      parameters:
        - key: options
          type: CreateOrganizationOptions
          expanded: true
          properties:
            - (Organization.Name)
            - key: DomainData
              type: 'OrganizationDomainDataOptions[]'
              optional: true
              properties:
                - key: Domain
                  type: string
                  description: (domain_data.domain)
                - key: State
                  type: OrganizationDomainDataState
                  description: (domain_data.state)
        - (cancellationToken)
      returns:
        - key: Task<Organization>
          description: (organization.self)
originalPath: .tmp-workos-clone/packages/docs/content/reference/organization/create.mdx
---

## Create an Organization

Creates a new organization in the current environment.

You can include one or more domains to associate with the organization, but you should [verify the ownership](/authkit/domain-verification) of every domain before setting its state to `verified`.

<CodeBlock referenceId="create_organization">
  <CodeBlockTab title="Request" file="create-organization-request" />
  <CodeBlockTab title="Response" file="create-organization-response" />
</CodeBlock>