# get_automation (/docs/mcp/tools/get-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/get_automation.mdx. */}

**Get automation** · Read-only

Returns the full setup of one automation: name, isActive, when (trigger event), then (action), trigger, interval, frequency settings (repeatWindowHours, dedupeScope), contact selection, email verification rules, filter and the action settings. Read it before update_automation. For what an automation did for a specific lead, use get_lead_automation_history. Get automationId from list_automations. Errors: 400 for an invalid id, 404 'automation not found.'

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

## Parameters [#parameters]

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `automationId` | `string` | Yes | Automation _id from list_automations (24 hex characters). |

## Tool definition [#tool-definition]

What your assistant receives from `tools/list`:

```json
{
  "name": "get_automation",
  "title": "Get automation",
  "annotations": {
    "title": "Get automation",
    "readOnlyHint": true,
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false
  },
  "inputSchema": {
    "type": "object",
    "properties": {
      "automationId": {
        "type": "string",
        "description": "Automation _id from list_automations (24 hex characters)."
      }
    },
    "required": [
      "automationId"
    ]
  }
}
```