Create a series

{
  "name": "March launch",
  "listId": "9f8e7d6c-1111-4bbb-8ccc-ddddeeeeffff",
  "startsAt": "2026-03-15T08:00:00.000Z",
  "audienceSegmentId": null,
  "audienceTagId": null
}

curl -s -X POST 'https://www.agentsmail.io/api/v1/series' \
  -H "x-api-key: $AGENTMAIL_API_KEY" \
  -H 'content-type: application/json' \
  -d '{
    "name": "March launch",
    "listId": "9f8e7d6c-1111-4bbb-8ccc-ddddeeeeffff",
    "startsAt": "2026-03-15T08:00:00.000Z"
  }'

{
  "success": true,
  "data": {
    "id": "7d7d7d7d-8888-4ccc-9ddd-eeee00001111",
    "name": "March launch",
    "status": "paused",
    "startsAt": "2026-03-15T08:00:00.000Z",
    "listId": "9f8e7d6c-1111-4bbb-8ccc-ddddeeeeffff",
    "audienceSegmentId": null,
    "audienceTagId": null,
    "topicId": null,
    "createdAt": "2026-03-01T10:00:00.000Z",
    "updatedAt": "2026-03-01T10:00:00.000Z"
  }
}

const headers = {
  'x-api-key': process.env.AGENTMAIL_API_KEY,
  'content-type': 'application/json',
}
const api = 'https://www.agentsmail.io/api/v1'

// 1. The series, with its audience and its start date
const {data: series} = await fetch(`${api}/series`, {
  method: 'POST',
  headers,
  body: JSON.stringify({name: 'March launch', listId, startsAt: '2026-03-15T08:00:00.000Z'}),
}).then((r) => r.json())

// 2. Its version 1 draft already exists — find it
const {data: versions} = await fetch(`${api}/sequences/${series.id}/versions`, {
  headers,
}).then((r) => r.json())
const draft = versions.find((v) => v.status === 'draft')

// 3. The steps, on the Sequences API — in TWO calls each for a send.
//    Creating a node only takes its `type` (plus `waitHours` on a wait, or
//    `templateId` to start from a template): a new send step is born with the
//    default content and no subject. The subject, the content and the send
//    time are written by a PATCH on the node that comes back.
const nodes = `${api}/sequences/${series.id}/versions/${draft.id}/nodes`

const addNode = (body) =>
  fetch(nodes, {method: 'POST', headers, body: JSON.stringify(body)})
    .then((r) => r.json())
    .then((r) => r.data)

const editNode = (id, body) =>
  fetch(`${nodes}/${id}`, {method: 'PATCH', headers, body: JSON.stringify(body)})
    .then((r) => r.json())
    .then((r) => r.data)

// One PATCH per FAMILY: the subject and the content are one family, the send
// time is another, and sending two families in a single call is refused.
const teaser = await addNode({type: 'send_email'})
await editNode(teaser.id, {subject: 'Something is coming', content: html})
// The time of day, in minutes from midnight. Leave it out and the step goes
// out as soon as the wait before it has elapsed.
await editNode(teaser.id, {sendTimeMinutes: 540})

// A wait gives the DURATION between two sends.
await addNode({type: 'wait', waitHours: 72})

const launch = await addNode({type: 'send_email'})
await editNode(launch.id, {subject: 'It is here', content: html2})
await editNode(launch.id, {sendTimeMinutes: 540})

// 4. Publish. This is where a series without a start date is refused, by name.
await fetch(`${api}/sequences/${series.id}/versions/${draft.id}/publish`, {
  method: 'POST',
  headers,
}).then((r) => r.json())