Sequences

Triggers#

A sequence starts when a contact is added to a list, gets a tag, tracks an event (including built in ones such as contact.created), or when you enrol them yourself. Only an active sequence enrols. Events that arrive while a sequence is paused or still a draft are not replayed when it is activated.

Steps#

Steps are numbered from 0. email sends a plan 06 email document through the marketing send path (unsubscribe link, suppression, frequency cap and tracking included). delay takes minutes, hours or days. condition checks a tag, a list, a field or an event since enrolment and jumps forward to on_true or on_false (a later step; empty means the next one). exit ends the run.

curl -X PUT https://api.runearc.com/v1/sequences/$SEQ/steps \
  -H "Authorization: Bearer $RUNEARC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "steps": [
    { "kind": "email", "subject": "Welcome aboard", "doc": {
        "version": 1, "style": "designed", "subject": "Welcome aboard",
        "blocks": [{ "type": "text", "text": "Hi {{FIRST_NAME|there}}," }] } },
    { "kind": "delay", "days": 1 },
    { "kind": "condition", "check": { "kind": "has_tag", "tag": "vip" }, "on_true": 4, "on_false": null },
    { "kind": "email", "subject": "How is it going?", "doc": { "version": 1, "style": "designed", "subject": "How is it going?", "blocks": [{ "type": "text", "text": "Anything we can help with?" }] } },
    { "kind": "exit", "reason": "done" }
  ] }'

Exit rules#

Before every pass the contact leaves when they unsubscribed or cannot receive marketing (unsubscribed), or when they tracked the sequence's goal event after enrolling (goal_reached). A contact has at most one active enrolment per sequence. After it ends they re-enter only if allow_reenroll is on and reenroll_after_days have passed; a manual enrolment with force skips the wait.

API#

GET/v1/sequences

POST/v1/sequences

PUT/v1/sequences/{id}/steps

POST/v1/sequences/{id}/activate

POST/v1/sequences/{id}/pause

POST/v1/sequences/{id}/enrollments

POST/v1/sequences/starters/{key}/install

Six starters ship with real copy: welcome, onboarding, trial-ending, win-back, churn-save and review-request. Install one as a draft, set the From address, then activate. The same operations exist as MCP tools and as runearc sequences ....