> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zeplo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Automation Tools

> List, toggle, trigger, and inspect automation workflow executions with the Zeplo MCP Server.

# 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:**

```json theme={null}
{
  "automationId": "auto_abc123",
  "contactId": "ct_xyz789",
  "conversationId": "conv_def456"
}
```

> [!WARNING]
>
> 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:**

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.