Texa Desk Application API · Labels

Create a label

POST/api/v1/accounts/{account_id}/labels

Create a label in the account

Authorization

api_access_tokenheaderrequired

A person's access token (Texa Desk, Profile settings → Access token) or an agent bot's token, in the api_access_token header. It acts as that person, with their role's permissions.

Path parameters

account_idintegerrequired

The numeric ID of the account

Body application/json

titlestring

The label title

descriptionstring

A short description for the label

colorstring

Hex color code for the label

show_on_sidebarboolean

Whether the label should appear in the sidebar

Responses

200

Success

idnumber

The ID of the label

titlestring

The title of the label

descriptionstring

The description of the label

colorstring

Hex color code for the label

show_on_sidebarboolean

Whether the label should appear in the sidebar

401

Unauthorized

descriptionstring

errorsarray of object

errors[].fieldstring

errors[].messagestring

errors[].codestring

curl -X POST 'https://desk.texadesk.com/api/v1/accounts/1/labels' \ -H "api_access_token: $TEXA_DESK_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "title": "support", "description": "Conversations that need support follow-up", "color": "#1f93ff" }'

import os, requests headers = {"api_access_token": os.environ["TEXA_DESK_TOKEN"]} body = { "title": "support", "description": "Conversations that need support follow-up", "color": "#1f93ff" } r = requests.post("https://desk.texadesk.com/api/v1/accounts/1/labels", headers=headers, json=body) r.raise_for_status() print(r.json())