Platform

Create automation for a connection agent

post/v1/platform/connections/{connectionId}/automations

Request

  • Base URL: https://api.1claw.co
  • URL: https://api.1claw.co/v1/platform/connections/{connectionId}/automations
  • Auth: HTTP bearer

Path parameters

connectionIdstring uuid required

Request body

namestring required
agent_idstring uuid required
trigger_type'cron' | 'event' | 'webhook' | 'manual' | 'schedule' required

cron | event | webhook | manual (alias schedule → cron)

cron_exprstring

Required when trigger_type is cron (or schedule)

timezonestring
event_filterobject nullable

Example request

{
  "cron_expr": "0 */6 * * *",
  "timezone": "UTC"
}

Response

Automation created

idstring uuid required
agent_idstring uuid required
namestring required
trigger_type'cron' | 'event' | 'webhook' | 'manual' required
cron_exprstring nullable
timezonestring required
event_filterobject nullable
is_activeboolean required
last_run_atstring date-time nullable
next_run_atstring date-time nullable
last_run_statusstring nullable

Status of the most recent run (enriched list field)

total_runsinteger nullable

Total runs in the last 30 days (enriched list field)

success_ratenumber nullable

Success rate percentage (enriched list field)

agent_namestring nullable

Resolved agent display name (enriched list field)

created_by_type'user' | 'agent'

Whether the automation was created by a human or agent (chat-native create)

created_atstring date-time required
updated_atstring date-time required
spec_versioninteger

Current automation_versions version.

webhook_signature_schemestring nullable

Inbound signature scheme name, never the secret.

webhook_urlstring

Full POST URL including token (one-time on create)

webhook_tokenstring

whk_ token segment (one-time on create)

Changes

No recorded changes to this operation across all 2 revisions of this API.