curl --request POST \
  --url https://brew.new/api/v1/automations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Welcome flow",
  "description": "Welcome new signups",
  "triggerEventId": "tri_signup",
  "nodes": [
    {
      "id": "trg",
      "label": "On signup",
      "type": "trigger",
      "config": {
        "actionType": "trigger"
      }
    },
    {
      "id": "send_welcome",
      "label": "Welcome",
      "type": "sendEmail",
      "config": {
        "actionType": "sendEmail",
        "emailId": "eml_welcome",
        "emailVersionId": "emv_welcome_v1",
        "domainId": "kx7bkh53hasmfeh5kd7sqgykt187g8ww",
        "subject": "Welcome to Brew, {{firstName | there}}!",
        "previewText": "Thanks for signing up, get started in 2 minutes.",
        "fromName": "Brew",
        "replyTo": "support@example.com"
      }
    }
  ],
  "connections": [
    {
      "from": "trg",
      "to": "send_welcome"
    }
  ]
}
'

Automations

Create an automation

Deterministic create, the body carries the full graph ({ name, triggerEventId?, nodes, connections }). Returns 201 with the bare AutomationRow.

Trigger binding (exactly one): for an EVENT automation pass triggerEventId (then publish with PATCH … { "published": true }). For a MANUAL-AUDIENCE automation OMIT triggerEventId and give the trigger node config: { "mode": "manualAudience", "audienceId": "aud_…" }. It is launched on demand with POST /v1/automations/{automationId}/run rather than published.

Chain POST /v1/emails { prompt } first to mint the design each sendEmail node references, every sendEmail node MUST carry emailId, emailVersionId, domainId, subject, previewText.

Dry-run. Add dryRun: true to validate without persisting; returns 200 with { valid, blockers[], warnings[], blockingIssues[], nodeCounts }. blockingIssues[] lists per-node references to a trigger-payload variable the bound trigger cannot provide ({ nodeId, nodeLabel, surface, variable, reason, fatal }), e.g. after swapping the trigger or removing a payload field. fatal: true (filter/split conditions and triple-brace {{{ }}} body tokens) fails publish; fatal: false (subject/previewText/fromName/replyTo and double-brace body tags) renders empty at send time and is advisory only. valid is false when any fatal blocking issue is present.

POST

automations

curl --request POST \
  --url https://brew.new/api/v1/automations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Welcome flow",
  "description": "Welcome new signups",
  "triggerEventId": "tri_signup",
  "nodes": [
    {
      "id": "trg",
      "label": "On signup",
      "type": "trigger",
      "config": {
        "actionType": "trigger"
      }
    },
    {
      "id": "send_welcome",
      "label": "Welcome",
      "type": "sendEmail",
      "config": {
        "actionType": "sendEmail",
        "emailId": "eml_welcome",
        "emailVersionId": "emv_welcome_v1",
        "domainId": "kx7bkh53hasmfeh5kd7sqgykt187g8ww",
        "subject": "Welcome to Brew, {{firstName | there}}!",
        "previewText": "Thanks for signing up, get started in 2 minutes.",
        "fromName": "Brew",
        "replyTo": "support@example.com"
      }
    }
  ],
  "connections": [
    {
      "from": "trg",
      "to": "send_welcome"
    }
  ]
}
'

Authorizations

Authorization

string

header

default:Bearer brew_your_api_key

required

Send your Brew API key as Authorization: Bearer brew_xxx.

Headers

Idempotency-Key

string

Optional idempotency key for safe retries. Reusing the same key with the same request body returns the original response for 24 hours.

Required string length: 1 - 100

Body

application/json

name

string

required

Required string length: 1 - 120

nodes

object[]

required

Maximum array length: 500

Option 1
Option 2
Option 3
Option 4
Option 5

Show child attributes

description

string

Maximum string length: 2000

triggerEventId

string

Required string length: 1 - 256

connections

object[]

Maximum array length: 1000

Show child attributes

dryRun

boolean

Response

Dry-run result (no writes). valid indicates whether the graph would publish cleanly.

Get automations Delete an automation

⌘I