API ReferenceAutomations
Switch an automation on
Checks everything (one trigger, every step connected, required settings filled) and switches it on: it then runs by itself whenever its trigger fires. Ask the user first. Switching on a "New comment" automation turns on the Inbox for the channels it watches. Owners and admins only.
Authorization
api-key AuthorizationBearer <token>
Workspace API key (nim_live_...)
In: header
Path Parameters
id*string
Format
uuidResponse Body
application/json
curl -X POST "https://example.com/v1/automations/497f6eca-6276-4993-bfeb-53cbbbba6f08/activate"{ "id": "9d2f4b1a-6c3e-4f8a-b5d7-1e0a2c4b6d8f", "name": "Monday planning reminder", "description": "string", "status": "DRAFT", "pausedReason": "CHANNEL_REMOVED", "managedBy": null, "trigger": { "type": "trigger.schedule", "summary": "On a schedule (0 9 * * 1 UTC)" }, "steps": [ { "id": "notify", "type": "action.notify", "name": "Send notification", "summary": "message: Time to plan the week" } ], "graph": { "nodes": [ { "id": "notify", "type": "action.notify", "name": "Remind the team", "position": { "x": 420, "y": 200 }, "params": {} } ], "edges": [ { "id": "e1", "source": "trigger", "target": "notify", "sourceHandle": "main" } ] }, "tags": [ "planning" ], "version": 1, "activateInApp": false, "lastRunAt": "string", "nextRunAt": "string", "createdAt": "2026-10-29T09:00:00.000Z", "updatedAt": "2026-10-29T09:00:00.000Z", "appUrl": "https://app.nimply.io/workspace/8b2e5821-…/automations/9d2f4b1a-…"}Empty
Empty
Empty
Empty