# toggle_automation (/docs/mcp/tools/toggle-automation)

{/* Generated by scripts/sync-mcp-tools.mjs from happierleads-api. Do not edit: change src/routes/mcp/toolDocs.json there, or add content/mcp-notes/toggle_automation.mdx. */}

**Turn automation on or off** · Changes data · Acts outside your account

Switches an automation on or off without changing its setup. When on, it acts on every matching lead (Slack messages, CRM pushes, campaign emails…). Get automationId from list_automations. An unfinished draft cannot be switched on: the call returns 405 and the draft has to be finished in the app first. Returns the updated automation.

| Connection | Account URL, team member URL or OAuth |
| --- | --- |

## Parameters [#parameters]

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `automationId` | `string` | Yes | Automation _id from list_automations. |
| `isActive` | `boolean` | Yes | true switches it on, false switches it off. |

## Tool definition [#tool-definition]

What your assistant receives from `tools/list`:

```json
{
  "name": "toggle_automation",
  "title": "Turn automation on or off",
  "annotations": {
    "title": "Turn automation on or off",
    "readOnlyHint": false,
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": true
  },
  "inputSchema": {
    "type": "object",
    "properties": {
      "automationId": {
        "type": "string",
        "description": "Automation _id from list_automations."
      },
      "isActive": {
        "type": "boolean",
        "description": "true switches it on, false switches it off."
      }
    },
    "required": [
      "automationId",
      "isActive"
    ]
  }
}
```