Docs
Automations

An automation's execution log

GEThttps://api.norreach.app/v1/automations/{id}/logs

What the engine did for this automation's contacts, newest first (sends, replies, blocked sends, gates timing out, contacts finishing). has_more says older entries exist beyond limit.

campaigns:readOperation id: list_automation_logs
GET/automations/{id}/logs
curl -X GET "https://api.norreach.app/v1/automations/{id}/logs" \
  -H "Authorization: Bearer $NORREACH_API_KEY"
An automation's execution log
{
  "object": "list",
  "data": [
    {
      "id": "981",
      "object": "automation_log",
      "at": "2026-11-04T09:12:33.120Z",
      "type": "email.sent",
      "label": "Email sent",
      "detail": "Step 1 · email",
      "tone": "ok",
      "contact_id": "7d1c3b2a-5e4f-4a1b-9c8d-0e1f2a3b4c5d",
      "contact_name": "Anna Lindqvist"
    }
  ],
  "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

Path parameters

idstring (uuid)pathrequired

An id (UUID).

Query parameters

limitintegerquery

Response

200application/json— An automation's execution log

object"list"required
dataobject[]required
Show child attributes
data[].idstringrequired
data[].object"automation_log"required
data[].atstringrequired

RFC 3339 UTC timestamp with milliseconds.

data[].typestringrequired

The event (email.sent, send.blocked, enrollment.completed …).

data[].labelstringrequired
data[].detailstring | nullrequired
data[].toneenumrequired
One of:okwarnerrorinfomuted
data[].contact_idstring (uuid) | nullrequired
data[].contact_namestring | nullrequired
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.
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.
404not_foundThat doesn't exist.
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.