Texa Desk Application API · Teams

Create a team

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

Create a team 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

account_idintegerrequired

The numeric ID of the account

Body application/json

namestring

The name of the team

descriptionstring

The description of the team

allow_auto_assignboolean

If this setting is turned on, the system would automatically assign the conversation to an agent in the team while assigning the conversation to a team

Responses

200

Success

idnumber

The ID of the team

namestring

The name of the team

descriptionstring

The description about the team

allow_auto_assignboolean

If this setting is turned on, the system would automatically assign the conversation to an agent in the team while assigning the conversation to a team

account_idnumber

The ID of the account with the team is a part of

is_memberboolean

This field shows whether the current user is a part of the team

401

Unauthorized

descriptionstring

errorsarray of object

errors[].fieldstring

errors[].messagestring

errors[].codestring

curl -X POST 'https://desk.texadesk.com/api/v1/accounts/1/teams' \ -H "api_access_token: $TEXA_DESK_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "name": "Support Team", "description": "This is a team of support agents", "allow_auto_assign": true }'

import os, requests headers = {"api_access_token": os.environ["TEXA_DESK_TOKEN"]} body = { "name": "Support Team", "description": "This is a team of support agents", "allow_auto_assign": True } r = requests.post("https://desk.texadesk.com/api/v1/accounts/1/teams", headers=headers, json=body) r.raise_for_status() print(r.json())