Texa Desk Application API · Automation rule

Add a new automation rule

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

Add a new automation rule to 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

namestring

Rule name

descriptionstring

The description about the automation and actions

event_namestring

The event when you want to execute the automation actions One of: conversation_created, conversation_updated, conversation_resolved, message_created.

activeboolean

Enable/disable automation rule

actionsarray of object

Array of actions which you want to perform when condition matches, e.g add label support if message contains content help.

conditionsarray of object

Array of conditions on which conversation filter would work, e.g message content contains text help.

Responses

200

Success

payloadarray of object or object

Response payload that contains automation rule(s)

403

Access denied

descriptionstring

errorsarray of object

errors[].fieldstring

errors[].messagestring

errors[].codestring

curl -X POST 'https://desk.texadesk.com/api/v1/accounts/1/automation_rules' \ -H "api_access_token: $TEXA_DESK_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "name": "Add label on message create event", "description": "Add label support and sales on message create event if incoming message content contains text help", "event_name": "message_created" }'

import os, requests headers = {"api_access_token": os.environ["TEXA_DESK_TOKEN"]} body = { "name": "Add label on message create event", "description": "Add label support and sales on message create event if incoming message content contains text help", "event_name": "message_created" } r = requests.post("https://desk.texadesk.com/api/v1/accounts/1/automation_rules", headers=headers, json=body) r.raise_for_status() print(r.json())

{ "payload": [ { "id": 1, "account_id": 1, "name": "Add label on message create event", "description": "Add label support and sales on message create event if incoming message content contains text help", "event_name": "message_created", "conditions": [ { "attribute_key": "content", "filter_operator": "contains", "values": [ "help" ], "query_operator": "and" } ], "actions": [ { "action_name": "add_label", "action_params": [ "support", "sales" ] } ], "created_on": 1, "active": true } ] }