Platform API · Accounts

Create an Account

POST/platform/api/v1/accounts

Authorization

api_access_tokenheaderrequired

A platform app's token. Platform apps exist only on a dedicated instance, made in its super admin console. On Texa's shared hosting this API is not open to companies.

Body application/json

namestring

Name of the account

localestring

The locale of the account

domainstring

The domain of the account

support_emailstring

The support email of the account

statusstring

The status of the account One of: active, suspended.

limitsobject

The limits of the account

custom_attributesobject

The custom attributes of the account

Responses

200

Success

idnumber

Account ID

namestring

Name of the account

401

Unauthorized

descriptionstring

errorsarray of object

errors[].fieldstring

errors[].messagestring

errors[].codestring

curl -X POST 'https://desk.texadesk.com/platform/api/v1/accounts' \ -H "api_access_token: $PLATFORM_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "name": "My Account", "locale": "en", "domain": "example.com" }'

import os, requests headers = {"api_access_token": os.environ["PLATFORM_TOKEN"]} body = { "name": "My Account", "locale": "en", "domain": "example.com" } r = requests.post("https://desk.texadesk.com/platform/api/v1/accounts", headers=headers, json=body) r.raise_for_status() print(r.json())