List automations
GET
https://api.norreach.app/v1/automationsThe workspace's automation flows, newest first, a page at a time. Filter by status (draft, active, paused, archived = stopped).
campaigns:readOperation id: list_automations
GET/automations
curl -X GET "https://api.norreach.app/v1/automations" \
-H "Authorization: Bearer $NORREACH_API_KEY"List automations
{
"object": "list",
"data": [
{
"id": "4d5e6f7a-8b9c-4d0e-9f1a-2b3c4d5e6f7a",
"object": "automation",
"name": "Webinar follow-up",
"status": "draft",
"trigger": "manual_contacts",
"node_count": 2,
"compiled_step_count": 0,
"created_at": "2026-11-04T09:12:33.120Z"
}
],
"has_more": false,
"next_cursor": null
}Authorizations
Authorizationstringheaderrequired
Bearer authentication: send Authorization: Bearer <key>, with an API key or an OAuth access token. The key needs the scope campaigns:read. API keys and scopes
Query parameters
limitintegerquery
Page size (1–200, default 50).
cursorstringquery
The next_cursor of the previous page.
statusenumquery
One of:
draftactivepausedarchivedResponse
200application/json— List automations
object"list"required
dataobject[]required
Show child attributesHide child attributes
data[].idstring (uuid)required
An id (UUID).
data[].object"automation"required
data[].namestringrequired
data[].statusstringrequired
draft, active, paused or archived (stopped).
data[].triggerstring | nullrequired
What starts the flow (e.g. manual_contacts, landing_form).
data[].node_countintegerrequired
data[].compiled_step_countintegerrequired
Steps in the program the engine runs (set when it is activated).
data[].created_atstringrequired
RFC 3339 UTC timestamp with milliseconds.
has_morebooleanrequired
next_cursorstring | nullrequired
Errors
Errors are application/problem+json with a stable code.
| Status | Code | Meaning |
|---|---|---|
| 400 | bad_request | The request couldn't be read. |
| 400 | unknown_field | The request has a field this operation doesn't know. |
| 400 | invalid_cursor | That cursor doesn't belong to this list. |
| 401 | unauthorized | A valid API key is required. |
| 403 | insufficient_scope | This API key doesn't have the scope this operation needs. |
| 403 | feature_not_enabled | The API isn't switched on for this workspace. |
| 429 | rate_limited | Too many requests. Slow down and try again. |
| 500 | server_error | Something went wrong on our side. |
| 503 | unavailable | The API isn't available right now. Try again shortly. |