Docs
Automations

List automations

GEThttps://api.norreach.app/v1/automations

The 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:draftactivepausedarchived

Response

200application/json— List automations

object"list"required
dataobject[]required
Show 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.

StatusCodeMeaning
400bad_requestThe request couldn't be read.
400unknown_fieldThe request has a field this operation doesn't know.
400invalid_cursorThat cursor doesn't belong to this list.
401unauthorizedA valid API key is required.
403insufficient_scopeThis API key doesn't have the scope this operation needs.
403feature_not_enabledThe API isn't switched on for this workspace.
429rate_limitedToo many requests. Slow down and try again.
500server_errorSomething went wrong on our side.
503unavailableThe API isn't available right now. Try again shortly.