> ## Documentation Index
> Fetch the complete documentation index at: https://www.text.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Create an organization

> Creates an organization and an account. Calling this endpoint won't result in email notifications. Alternatively, you can use Bearer/Basic authorization instead of creating a new account for an organization; it will create a new organization for the account associated with the token.



## OpenAPI

````yaml /api/global-accounts/openapi.json post /organizations
openapi: 3.0.0
info:
  title: Global Accounts API
  description: >-
    API used to manage Organizations and Accounts for multiple products. Also
    responsible for authorization and authentication processes.
  version: 2.0.0
servers:
  - url: https://accounts.livechat.com/v2
    description: Main production server URL
security: []
paths:
  /organizations:
    post:
      tags:
        - Organizations
      summary: Create an organization
      description: >-
        Creates an organization and an account. Calling this endpoint won't
        result in email notifications. Alternatively, you can use Bearer/Basic
        authorization instead of creating a new account for an organization; it
        will create a new organization for the account associated with the
        token.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              properties:
                email:
                  type: string
                  format: email
                  description: The account's email address.
                  exclusiveMaximum: false
                  maxLength: 128
                password:
                  type: string
                  writeOnly: true
                  exclusiveMaximum: false
                  maxLength: 255
                  exclusiveMinimum: false
                  minLength: 8
                  description: The password for a given account.
                organization:
                  allOf:
                    - description: >-
                        Organization groups accounts into a single unit. Each
                        organization must contain at least one account and one
                        owner. An account can be assigned to many organizations
                        at once. The default organization is the first assigned
                        to a given account.
                      type: object
                      properties:
                        organization_id:
                          type: string
                          format: uuid
                          default: my
                          readOnly: true
                          description: Unique organization identifier.
                        name:
                          type: string
                          description: The organization name.
                          exclusiveMaximum: false
                          maxLength: 127
                        invitation_mode:
                          type: string
                          description: >-
                            Controls invitation permissions for the
                            organization. Determines whether all paid roles or
                            only privileged roles can send product invitations.
                          enum:
                            - lax
                            - strict
                          default: lax
                        domain_whitelist:
                          type: boolean
                          description: >-
                            If `true`: email address domain whitelisting is
                            enabled.
                          default: false
                        products:
                          type: array
                          description: Installed products in the organization.
                          readOnly: true
                          items:
                            type: object
                            properties:
                              product:
                                type: string
                                description: The default product for the account.
                                enum:
                                  - LiveChat
                                  - Accounts
                                  - ChatBot
                                  - HelpDesk
                                  - OpenWidget
                              created_at:
                                readOnly: true
                                type: string
                                format: date-time
                                description: Creation date of the resource.
                        updated_at:
                          readOnly: true
                          type: string
                          format: date-time
                          description: >-
                            Date of the most recent modification to the
                            resource.
                        created_at:
                          readOnly: true
                          type: string
                          format: date-time
                          description: Creation date of the resource.
                    - type: object
                      properties:
                        company:
                          description: Basic company information.
                          type: object
                          properties:
                            phone:
                              type: string
                              description: The company phone number.
                              exclusiveMaximum: false
                              maxLength: 20
                            website:
                              type: string
                              description: The primary company website.
                              exclusiveMaximum: false
                              maxLength: 255
                            name:
                              type: string
                              description: The company name.
                              exclusiveMaximum: false
                              maxLength: 255
                            industry:
                              type: string
                              description: The company industry.
                              exclusiveMaximum: false
                              maxLength: 255
                            company_size:
                              type: string
                              description: The company size.
                              exclusiveMaximum: false
                              maxLength: 255
                            audience:
                              type: array
                              description: The company audience.
                              items:
                                type: string
                                enum:
                                  - B2B
                                  - B2C
                                  - Internal use
                              uniqueItems: true
                            street:
                              type: string
                              description: The company street address.
                              exclusiveMaximum: false
                              maxLength: 255
                            city:
                              type: string
                              description: The company city.
                              exclusiveMaximum: false
                              maxLength: 255
                            state:
                              type: string
                              description: The company state.
                              exclusiveMaximum: false
                              maxLength: 255
                            zipcode:
                              type: string
                              description: The company zipcode.
                              exclusiveMaximum: false
                              maxLength: 20
                            country:
                              type: string
                              description: The company country.
                              exclusiveMaximum: false
                              maxLength: 255
                            logo:
                              type: string
                              description: The company logo URL.
                              exclusiveMaximum: false
                              maxLength: 65535
                            tagline:
                              type: string
                              description: The company tagline.
                              exclusiveMaximum: false
                              maxLength: 65535
                            twitter:
                              type: string
                              description: The company Twitter profile.
                              maxLength: 255
                              exclusiveMaximum: false
                            instagram:
                              type: string
                              description: The company Instagram profile.
                              maxLength: 255
                              exclusiveMaximum: false
                            linkedin:
                              type: string
                              description: The company LinkedIn profile.
                              maxLength: 255
                              exclusiveMaximum: false
                            facebook:
                              type: string
                              description: The company Facebook profile.
                              maxLength: 255
                              exclusiveMaximum: false
              required:
                - email
            example:
              email: john@example.com
              password: password123
              organization:
                name: Text
      responses:
        '200':
          description: 'OK: Returns the account and the organization.'
          content:
            application/json:
              schema:
                allOf:
                  - description: An entity of the account, used across all Text products.
                    type: object
                    required:
                      - email
                    properties:
                      account_id:
                        type: string
                        format: uuid
                        readOnly: true
                        description: Unique account identifier.
                      name:
                        type: string
                        description: >-
                          The account name (nick; first name, second name, or
                          both).
                        exclusiveMaximum: false
                        maxLength: 191
                      email:
                        type: string
                        format: email
                        description: The account's email address.
                        exclusiveMaximum: false
                        maxLength: 128
                      email_verified:
                        type: boolean
                        readOnly: true
                        description: >-
                          If `true`: the account's email was verified via an
                          email action or by a third-party identity provider.
                      default_product:
                        type: string
                        description: The default product for the account.
                        enum:
                          - LiveChat
                          - Accounts
                          - ChatBot
                          - HelpDesk
                          - OpenWidget
                      default_organization_id:
                        type: string
                        format: uuid
                        description: >-
                          The ID of the default organization the account belongs
                          to.
                        default: null
                        nullable: true
                      avatar_url:
                        type: string
                        description: >-
                          The "Account's avatar" field has been deprecated and
                          is no longer recommended for use; instead, the avatar
                          functionality has been relocated to the account
                          organization settings.
                        default: null
                        nullable: true
                        exclusiveMaximum: false
                        maxLength: 255
                        deprecated: true
                      roles:
                        type: array
                        items:
                          description: >-
                            Role groups account scopes into one permission
                            entity.
                          type: object
                          properties:
                            role_id:
                              type: string
                              description: Unique role definition ID.
                            product:
                              type: string
                              description: The product the role belongs to.
                              enum:
                                - LiveChat
                                - Accounts
                                - ChatBot
                                - HelpDesk
                                - OpenWidget
                            role:
                              type: string
                              description: >-
                                The role name; can be one of the predefined
                                roles or a custom role name.
                              enum:
                                - owner
                                - viceowner
                                - administrator
                                - normal
                                - member
                            type:
                              type: string
                              readOnly: true
                              description: >-
                                The role type: `primary` is an obligatory
                                accounts role, `secondary` is a basic product
                                role, `custom` is a custom-defined role.
                            predefined:
                              readOnly: true
                              type: boolean
                              description: >-
                                If `true`: the role is common across all
                                organizations. If `false`: the role is specific
                                to an organization.
                        description: >-
                          Roles associated with the account; returned only when
                          the access token contains the `accounts.roles--all:ro`
                          scope.
                      updated_at:
                        readOnly: true
                        type: string
                        format: date-time
                        description: The date of the account's last update.
                      created_at:
                        readOnly: true
                        type: string
                        format: date-time
                        description: The date the account was created.
                  - type: object
                    properties:
                      organization:
                        allOf:
                          - description: >-
                              Organization groups accounts into a single unit.
                              Each organization must contain at least one
                              account and one owner. An account can be assigned
                              to many organizations at once. The default
                              organization is the first assigned to a given
                              account.
                            type: object
                            properties:
                              organization_id:
                                type: string
                                format: uuid
                                default: my
                                readOnly: true
                                description: Unique organization identifier.
                              name:
                                type: string
                                description: The organization name.
                                exclusiveMaximum: false
                                maxLength: 127
                              invitation_mode:
                                type: string
                                description: >-
                                  Controls invitation permissions for the
                                  organization. Determines whether all paid
                                  roles or only privileged roles can send
                                  product invitations.
                                enum:
                                  - lax
                                  - strict
                                default: lax
                              domain_whitelist:
                                type: boolean
                                description: >-
                                  If `true`: email address domain whitelisting
                                  is enabled.
                                default: false
                              products:
                                type: array
                                description: Installed products in the organization.
                                readOnly: true
                                items:
                                  type: object
                                  properties:
                                    product:
                                      type: string
                                      description: The default product for the account.
                                      enum:
                                        - LiveChat
                                        - Accounts
                                        - ChatBot
                                        - HelpDesk
                                        - OpenWidget
                                    created_at:
                                      readOnly: true
                                      type: string
                                      format: date-time
                                      description: Creation date of the resource.
                              updated_at:
                                readOnly: true
                                type: string
                                format: date-time
                                description: >-
                                  Date of the most recent modification to the
                                  resource.
                              created_at:
                                readOnly: true
                                type: string
                                format: date-time
                                description: Creation date of the resource.
                          - type: object
                            properties:
                              company:
                                description: Basic company information.
                                type: object
                                properties:
                                  phone:
                                    type: string
                                    description: The company phone number.
                                    exclusiveMaximum: false
                                    maxLength: 20
                                  website:
                                    type: string
                                    description: The primary company website.
                                    exclusiveMaximum: false
                                    maxLength: 255
                                  name:
                                    type: string
                                    description: The company name.
                                    exclusiveMaximum: false
                                    maxLength: 255
                                  industry:
                                    type: string
                                    description: The company industry.
                                    exclusiveMaximum: false
                                    maxLength: 255
                                  company_size:
                                    type: string
                                    description: The company size.
                                    exclusiveMaximum: false
                                    maxLength: 255
                                  audience:
                                    type: array
                                    description: The company audience.
                                    items:
                                      type: string
                                      enum:
                                        - B2B
                                        - B2C
                                        - Internal use
                                    uniqueItems: true
                                  street:
                                    type: string
                                    description: The company street address.
                                    exclusiveMaximum: false
                                    maxLength: 255
                                  city:
                                    type: string
                                    description: The company city.
                                    exclusiveMaximum: false
                                    maxLength: 255
                                  state:
                                    type: string
                                    description: The company state.
                                    exclusiveMaximum: false
                                    maxLength: 255
                                  zipcode:
                                    type: string
                                    description: The company zipcode.
                                    exclusiveMaximum: false
                                    maxLength: 20
                                  country:
                                    type: string
                                    description: The company country.
                                    exclusiveMaximum: false
                                    maxLength: 255
                                  logo:
                                    type: string
                                    description: The company logo URL.
                                    exclusiveMaximum: false
                                    maxLength: 65535
                                  tagline:
                                    type: string
                                    description: The company tagline.
                                    exclusiveMaximum: false
                                    maxLength: 65535
                                  twitter:
                                    type: string
                                    description: The company Twitter profile.
                                    maxLength: 255
                                    exclusiveMaximum: false
                                  instagram:
                                    type: string
                                    description: The company Instagram profile.
                                    maxLength: 255
                                    exclusiveMaximum: false
                                  linkedin:
                                    type: string
                                    description: The company LinkedIn profile.
                                    maxLength: 255
                                    exclusiveMaximum: false
                                  facebook:
                                    type: string
                                    description: The company Facebook profile.
                                    maxLength: 255
                                    exclusiveMaximum: false
                      access_token:
                        type: string
              example:
                account_id: 496a94f2-cbbf-444e-a3cb-305b9f5f8cbb
                name: John
                email: john@example.com
                email_verified: false
                default_product: LiveChat
                default_organization_id: b2185556-634c-4ecf-b4c9-bcf8b65bc853
                avatar_url: null
                roles: []
                updated_at: '2026-06-03T10:53:04.000Z'
                created_at: '2026-06-03T10:53:04.000Z'
                organization:
                  organization_id: b2185556-634c-4ecf-b4c9-bcf8b65bc853
                  name: Text
                  invitation_mode: lax
                  domain_whitelist: false
                access_token: >-
                  us-south1:test_tW5tQ-yBR2iQgGM6rWbz3w.lfVHLsxoJnrNJZ7JFZkYFwTEr2g-d3nPvt
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                allOf:
                  - description: The default error object.
                    type: object
                    properties:
                      error:
                        description: The error code.
                        type: string
                        enum:
                          - bad_request
                          - invalid_request
                          - unauthorized_client
                          - unauthorized
                          - access_denied
                          - unsupported_response_type
                          - invalid_scope
                          - server_error
                          - temporarily_unavailable
                          - unsupported_grant_type
                          - invalid_grant
                          - invalid_client
                          - conflict
                          - resource_not_found
                          - join_link_expired
                          - traffic_blocked
                          - not_implemented
                      error_description:
                        type: string
                      sub_error:
                        description: The error subcode.
                        type: string
                        nullable: true
                      request_id:
                        description: Unique request identifier.
                        type: string
                        format: uuid
                  - type: object
                    properties:
                      error:
                        type: string
                      error_description:
                        type: string
              example:
                error: bad_request
                error_description: >-
                  The server cannot or will not process the request due to an
                  apparent client error (for example, malformed request syntax,
                  size too large).
                request_id: 5903c51b-89f0-41a9-a25d-4f39af100353
        '409':
          description: 'Conflict: The account already exists.'
          content:
            application/json:
              schema:
                allOf:
                  - description: Returned on validation errors.
                    allOf:
                      - description: The default error object.
                        type: object
                        properties:
                          error:
                            description: The error code.
                            type: string
                            enum:
                              - bad_request
                              - invalid_request
                              - unauthorized_client
                              - unauthorized
                              - access_denied
                              - unsupported_response_type
                              - invalid_scope
                              - server_error
                              - temporarily_unavailable
                              - unsupported_grant_type
                              - invalid_grant
                              - invalid_client
                              - conflict
                              - resource_not_found
                              - join_link_expired
                              - traffic_blocked
                              - not_implemented
                          error_description:
                            type: string
                          sub_error:
                            description: The error subcode.
                            type: string
                            nullable: true
                          request_id:
                            description: Unique request identifier.
                            type: string
                            format: uuid
                      - type: object
                        properties:
                          resource_name:
                            description: The name of the resource related to the error.
                            type: string
                          resource_id:
                            description: >-
                              The identifier of the resource related to the
                              error.
                            type: string
                  - type: object
                    properties:
                      error:
                        type: string
                      error_description:
                        type: string
              example:
                error: conflict
                error_description: >-
                  The request couldn't be processed because of conflict in the
                  current state of the resource.
                resource_name: account
                resource_id: 5903c51b-89f0-41a9-a25d-4f39af100353
                request_id: 5903c51b-89f0-41a9-a25d-4f39af100353
        '422':
          description: 'Validation error: Invalid email address, name too long, etc.'
          content:
            application/json:
              schema:
                allOf:
                  - allOf:
                      - description: The default error object.
                        type: object
                        properties:
                          error:
                            description: The error code.
                            type: string
                            enum:
                              - bad_request
                              - invalid_request
                              - unauthorized_client
                              - unauthorized
                              - access_denied
                              - unsupported_response_type
                              - invalid_scope
                              - server_error
                              - temporarily_unavailable
                              - unsupported_grant_type
                              - invalid_grant
                              - invalid_client
                              - conflict
                              - resource_not_found
                              - join_link_expired
                              - traffic_blocked
                              - not_implemented
                          error_description:
                            type: string
                          sub_error:
                            description: The error subcode.
                            type: string
                            nullable: true
                          request_id:
                            description: Unique request identifier.
                            type: string
                            format: uuid
                      - type: object
                        properties:
                          error:
                            type: string
                          error_description:
                            type: string
                          invalid_fields:
                            type: object
                            additionalProperties:
                              type: string
                  - type: object
                    properties:
                      invalid_fields:
                        type: object
                        properties:
                          email:
                            type: string
              example:
                error: invalid_request
                error_description: >-
                  The request is missing a required parameter, includes an
                  invalid parameter value, includes a parameter more than once,
                  or is otherwise malformed.
                invalid_fields:
                  email: invalid email address
                request_id: 5903c51b-89f0-41a9-a25d-4f39af100353
        '500':
          description: Server Error.
          content:
            application/json:
              schema:
                allOf:
                  - description: The default error object.
                    type: object
                    properties:
                      error:
                        description: The error code.
                        type: string
                        enum:
                          - bad_request
                          - invalid_request
                          - unauthorized_client
                          - unauthorized
                          - access_denied
                          - unsupported_response_type
                          - invalid_scope
                          - server_error
                          - temporarily_unavailable
                          - unsupported_grant_type
                          - invalid_grant
                          - invalid_client
                          - conflict
                          - resource_not_found
                          - join_link_expired
                          - traffic_blocked
                          - not_implemented
                      error_description:
                        type: string
                      sub_error:
                        description: The error subcode.
                        type: string
                        nullable: true
                      request_id:
                        description: Unique request identifier.
                        type: string
                        format: uuid
                  - type: object
                    properties:
                      error:
                        type: string
                      error_description:
                        type: string
              example:
                error: server_error
                error_description: >-
                  The server encountered an unexpected condition that prevented
                  it from fulfilling the request.
                request_id: 5903c51b-89f0-41a9-a25d-4f39af100353

````