Automation Tools

Tools for managing visual automation flows and their executions.

automation_list

List automation flows with status filtering. Parameters:

Parameter	Type	Required	Default	Description
`channelId`	string	No	—	Filter by channel ID
`status`	string	No	—	Filter by status: `active`, `inactive`, `paused`
`page`	number	No	1	Page number
`limit`	number	No	20	Items per page

automation_get

Get automation details including its flow nodes and edges. Parameters:

Parameter	Type	Required	Description
`id`	string	Yes	Automation ID

Response includes: all automation fields plus nodes, edges, nodeCount, and edgeCount arrays describing the visual flow structure.

automation_toggle

Activate, deactivate, or pause an automation. Parameters:

Parameter	Type	Required	Description
`id`	string	Yes	Automation ID
`status`	enum	Yes	New status: `active`, `inactive`, `paused`

automation_execute

Trigger an automation execution for a specific contact. Parameters:

Parameter	Type	Required	Description
`automationId`	string	Yes	Automation ID to execute
`contactId`	string	Yes	Contact ID to execute for
`conversationId`	string	No	Optional conversation ID

Example:

{
  "automationId": "auto_abc123",
  "contactId": "ct_xyz789",
  "conversationId": "conv_def456"
}

The automation must be in active status to be executed. Attempting to execute a paused or inactive automation will return an error.

automation_executions

Get execution history for an automation. Parameters:

Parameter	Type	Required	Default	Description
`automationId`	string	Yes	—	Automation ID
`status`	string	No	—	Filter by execution status
`limit`	number	No	20	Max results

Response:

{
  "automationId": "auto_abc123",
  "count": 15,
  "executions": [
    {
      "id": "exec_abc123",
      "contactId": "ct_xyz789",
      "status": "completed",
      "createdAt": "2026-05-08T09:00:00.000Z"
    }
  ]
}

Getting Started

Tools Reference

Resources

Automation Tools

Automation Tools

automation_list

automation_get

automation_toggle

automation_execute

automation_executions

​Automation Tools

​automation_list

​automation_get

​automation_toggle

​automation_execute

​automation_executions

Automation Tools

automation_list

automation_get

automation_toggle

automation_execute

automation_executions