Skip to main content
POST
Create an organization

Body

application/json
email
string<email>
required

The account's email address.

Maximum string length: 128
password
string
write-only

The password for a given account.

Required string length: 8 - 255
organization
object

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.

Response

OK: Returns the account and the organization.

An entity of the account, used across all Text products.

email
string<email>
required

The account's email address.

Maximum string length: 128
account_id
string<uuid>
read-only

Unique account identifier.

name
string

The account name (nick; first name, second name, or both).

Maximum string length: 191
email_verified
boolean
read-only

If true: the account's email was verified via an email action or by a third-party identity provider.

default_product
enum<string>

The default product for the account.

Available options:
LiveChat,
Accounts,
ChatBot,
HelpDesk,
OpenWidget
default_organization_id
string<uuid> | null

The ID of the default organization the account belongs to.

avatar_url
string | null
deprecated

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.

Maximum string length: 255
roles
object[]

Roles associated with the account; returned only when the access token contains the accounts.roles--all:ro scope.

updated_at
string<date-time>
read-only

The date of the account's last update.

created_at
string<date-time>
read-only

The date the account was created.

organization
object

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.

access_token
string