automations

Create an automation: a trigger plus ordered steps (email, webhook, A/B split), or Resend’s graph of steps and connections (delay, wait for event, condition,…

Create an automation: a trigger plus ordered steps (email, webhook, A/B split), or Resend’s graph of steps and connections (delay, wait for event, condition, send email, contact update and delete, add to segment).

post/automations

Request

  • Base URL: https://api.agentisend.com
  • URL: https://api.agentisend.com/automations
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Makes this call safe to retry. Send the same key with the same body and the original response is replayed instead of the work happening twice. Keys are 1-256 characters and are remembered for 7 days. While the first attempt is still running, a second call with that key returns 409 idempotency_in_flight (Resend calls this concurrent_idempotent_requests); the same key with a different body returns 409 idempotency_payload_mismatch (Resend: invalid_idempotent_request). Resend-Idempotency-Key is accepted as the same header.

Resend-Idempotency-Keystring

Alias of Idempotency-Key. Idempotency-Key wins if both are sent.

Request body

namestring required
status'enabled' | 'disabled'

enabled starts firing now. A graph defaults to disabled; a linear automation is a draft until enabled.

stepsobject[] required

Linear: ordered steps with kind email, webhook or ab_split, beside a trigger. Graph (Resend): steps with key, type (trigger, delay, send_email, wait_for_event, condition, contact_update, contact_delete, add_to_segment) and config, sent together with connections. A graph has exactly one trigger step, at most 150 steps, every step reachable from the trigger and no loops.

Response

Success

object'automation' required
idstring uuid required
namestring required
statusstring required
format'linear' | 'graph' required
current_versioninteger required
created_atstring date-time required
updated_atstring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.