Automations

List automations

Returns the paginated list of the client's active automations (cursor v2). Stable sort created_at DESC, id DESC. Archived automations (archived_at IS NOT NULL) are excluded — the public API does not expose them.

Filters

• ?status=active — only automations with is_active=true.
• ?status=inactive — only automations with is_active=false.

Read-only

The public API only exposes read access (list + history) and manual triggering. Creating, editing and archiving an automation happen in the dashboard — there is no POST/PATCH/DELETE /v1/automations endpoint.

curl -X GET 'https://api.capturia.io/v1/automations' \
  -H 'Authorization: Bearer cap_live_<your-key>' \
  -H 'Content-Type: application/json'

Manually trigger an automation

Creates an execution with status="pending" and trigger_type="manual_api", claimable by the automation engine (asynchronous, no guarantee of synchronous completion). To track the execution's progress, call GET /v1/automations/{id}/history.

Preconditions

• Automations must not have been removed from the account — otherwise 403 feature_not_available.
• The automation must belong to the calling client and must not be archived — otherwise 404 not_found.
• The automation must have is_active=true — otherwise 409 automation_inactive.
• The automation must be published — otherwise 409 automation_not_published.
• The published automation must have a trigger node — otherwise 409 no_trigger.
• The contact_id must belong to the calling client — otherwise 404 not_found. A contact absorbed by a merge also returns 404 not_found: trigger on the contact that was kept.

Enrollment guards

Manual triggering goes through the same guards as automatic triggers:

• Contact already in an active run of this automation — otherwise 409 already_enrolled (turn on Multiple concurrent runs in the Enrollment settings to allow concurrent runs).
• Duplicate within the last 5 minutes, cap of 5 enrollments per contact per 24 h on this automation, or global cap of 200 executions per hour for the account — otherwise 429 trigger_throttled.

The body accepts an optional event_data (free-form JSON object) injected into the execution and available to the graph's template variables.

curl -X POST 'https://api.capturia.io/v1/automations/{id}/trigger' \
  -H 'Authorization: Bearer cap_live_<your-key>' \
  -H 'Content-Type: application/json' \
  -d '{
  "contact_id": "8f3b1a2c-9d4e-4f5a-b6c7-d8e9f0a1b2c3",
  "event_data": {
    "source": "crm_import"
  }
}'

List an automation's execution history

Returns the paginated list of an automation's executions (cursor v2). Stable sort created_at DESC, id DESC — most recent executions first. An execution is one run of the automation for a given contact; the engine can restart it after a failure (retry_count > 0).

The automation must belong to the calling client and must not be archived — otherwise 404 not_found.

curl -X GET 'https://api.capturia.io/v1/automations/{id}/history' \
  -H 'Authorization: Bearer cap_live_<your-key>' \
  -H 'Content-Type: application/json'