Create an outreach cadence

POSThttps://myagentmail.com/cadences

A cadence is a server-side outreach sequence — an ordered list of steps (LinkedIn invite → wait → DM → email → ...) that fire automatically per enrollment with branching on real-world events (invite accepted, lead replied).

The runtime is on MyAgentMail's side. Customer apps call POST /v1/cadences/:id/enrollments to enroll a lead and receive webhook events as the cadence progresses.

Request body

Content-Type: application/json

`name` required string
`description` string
`businessHoursOnly` boolean	default: true
`exitOnReply` boolean	default: true
`exitOnUnsubscribe` boolean	default: true
`dailySendCap` integer	default: 50
`webhookUrl` string	format: uri
`steps` object[]	Optional inline step list. You can also PATCH /v1/cadences/:id/steps later.
`kind` required "linkedin_connect" \| "linkedin_message" \| "email" \| "wait"	enum: "linkedin_connect" \| "linkedin_message" \| "email" \| "wait"
`delayDays` required number	Days after the previous step's completion. 0 = fire on enrollment for step 0; 0.25 = 6 hours.
`condition` "after_accept" \| "no_reply_to_prev" \| "never_replied"	enum: "after_accept" \| "no_reply_to_prev" \| "never_replied"
`draftStrategy` "ai" \| "static"	enum: "ai" \| "static" default: "ai"
`staticSubject` string
`staticBody` string
`promptHint` string
`notes` string

Responses

201application/jsonCadence created.

`ok` boolean
`cadence` object
`id` string	format: uuid
`name` string
`description` string
`enabled` boolean
`businessHoursOnly` boolean
`exitOnReply` boolean
`exitOnUnsubscribe` boolean
`dailySendCap` integer
`webhookUrl` string
`webhookSecret` string	HMAC secret for X-MyAgentMail-Signature.
`createdAt` string	format: date-time
`updatedAt` string	format: date-time
`steps` any[]

Authentication

Send your API key in the X-API-Key header (or Authorization: Bearer <key>). Any prefix accepted by this endpoint — tk_, wk_, ak_, or sa_ — is documented in the key prefix table.

Request

import { MyAgentMail } from "myagentmail";

const client = new MyAgentMail({ apiKey: process.env.MYAGENTMAIL_API_KEY! });

// POST /cadences
const result = await client.request("post", "/cadences", { body: {
  "name": "string",
  "description": "string",
  "businessHoursOnly": true,
  "exitOnReply": true,
  "exitOnUnsubscribe": true,
  "dailySendCap": 50,
  "webhookUrl": "https://example.com",
  "steps": [
    {
      "kind": "linkedin_connect",
      "delayDays": 0,
      "condition": "after_accept",
      "draftStrategy": "ai",
      "staticSubject": "string",
      "staticBody": "string",
      "promptHint": "string",
      "notes": "string"
    }
  ]
} });

Example response · 201

{
  "ok": false,
  "cadence": {
    "id": "00000000-0000-0000-0000-000000000000",
    "name": "string",
    "description": "string",
    "enabled": false,
    "businessHoursOnly": false,
    "exitOnReply": false,
    "exitOnUnsubscribe": false,
    "dailySendCap": 0,
    "webhookUrl": "string",
    "webhookSecret": "string",
    "createdAt": "2026-05-01T08:11:44.995Z",
    "updatedAt": "2026-05-01T08:11:44.995Z",
    "steps": [
      {
        "kind": "linkedin_connect",
        "delayDays": 0,
        "condition": "after_accept",
        "draftStrategy": "ai",
        "staticSubject": "string",
        "staticBody": "string",
        "promptHint": "string",
        "notes": "string",
        "id": "00000000-0000-0000-0000-000000000000",
        "cadenceId": "00000000-0000-0000-0000-000000000000",
        "stepIndex": 0
      }
    ]
  }
}