Totango provides an API for managing tasks in Totango from external systems:

• Create
• Update
• Delete

Before you begin

• The user setting up the API must be a Totango admin
• You need your Totango API token key 
• For US services, please use https://api.totango.com
• For EU services, please use https://api-eu1.totango.com 
• Like all APIs, there is a global rate limit of 100 calls/minute for each token
• JSON format is supported for API calls

Create a task

Use the following: {US or EU api URL}/api/v3/tasks

• Replace APP_TOKEN with your authentication token.
• Task priority options in CURL include: 1 (high), 2 (normal), or 3 (low).
• Replace username with assignee email or uuid.
• Replace account-id with the account id.
• Replace activity-type-id with the flow ID (required). To get the ID of a flow use the /api/v3/activity-types endpoint as describe here.
• Replace status-label-id with the task status label id (optional). To get the ID of task status labels, use the /api/v3/events endpoint as described here.
• Legacy status values: open / closed. When sending status_label_id, status and status_category are set automatically. If values conflict, status_label_id takes precedence.

curl --location 'https://api.totango.com/api/v3/tasks' \
--header 'app-token: APP_TOKEN' \
--header 'Content-Type: application/json' \
--data-raw '{
    "title": "task title",
    "description": "task description",
    "due_date": "2024-02-28",
    "priority": 2,
    "status": "open",
    "status_label_id": "status-label-id",
    "account_id": "account-id",
    "assignee": "username",
    "activity_type_id": "activity-type-id"
}'

Response

If successful, the task will be triggered and response is returned: Success

If validation does not pass due to account not found, response is returned:
Status 400, message “Account not found"

Update a task

Use the following: {US or EU api URL}/api/v3/tasks/{task-id}

• Replace {task-id} with the id of the task to update.
• Replace APP_TOKEN with your authentication token.
• Task priority options in CURL include: 1 (high), 2 (normal), or 3 (low).
• Replace username with assignee email or uuid.
• Replace account-id with the account id.
• Replace label-id with the task status label id (optional). To get the ID of task status labels, use the /api/v3/events endpoint as described here.
• Legacy status values: open / closed

curl --location --request PUT 'https://api.totango.com/api/v3/tasks/{task-id}' \
--header 'app-token: APP_TOKEN' \
--header 'Content-Type: application/json' \
--data '{"priority":"3", "due_date": "2024-02-25", "assignee": "username", "account_id":"account-id", "status_label_id": "45de43fe-1b17-47d2-9dbf-996aa891b00e"}'

Response

If successful, the response is returned: Success

If validation does not pass due to account not found, response is returned:
Status 400, message “Account not found"

Delete a task

Use the following: {US or EU api URL}/api/v3/tasks/{task-id}

• Replace {task-id} with the id of the task to update.
• Replace APP_TOKEN with your authentication token.
• Replace account-id with the account id.

curl --location --request PUT 'https://api.totango.com/api/v3/tasks/{task-id}' \
--header 'app-token: APP_TOKEN' \
--header 'Content-Type: text/plain' \
--data '{"account_id":"account-id"}'

Response

If successful, the response is returned: Success

If validation does not pass due to account not found, response is returned:
Status 400, message “Account not found"