Drip Sequences

Create automated email series that send over time.

Drip sequences are automated email series. Create a sequence, add steps with delays, then activate to start sending.

GET/api/v1/drip

List all drip sequences for the current workspace.

Response

{
  "data": [
    {
      "id": "drip_abc123",
      "name": "Welcome Series",
      "status": "active",
      "stepsCount": 5,
      "enrolledCount": 1240,
      "createdAt": "2026-02-15T10:00:00Z"
    }
  ]
}

POST/api/v1/drip

Create a new drip sequence.

Parameters

Name	Type	Description
`name`required	string	Display name for the sequence
`description`	string	Internal description of the sequence purpose
`listId`	string	Subscriber list to target
`fromName`	string	Sender display name
`fromEmail`	string	Sender email address

Example

curl -X POST https://app.clawdmail.ai/api/v1/drip \
  -H "Authorization: Bearer cm_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Welcome Series",
    "description": "Onboarding emails for new signups",
    "listId": "list_abc123",
    "fromName": "Acme Team",
    "fromEmail": "hello@acme.com"
  }'

Response

{
  "data": {
    "id": "drip_x7k9m2",
    "name": "Welcome Series",
    "status": "draft",
    "stepsCount": 0,
    "createdAt": "2026-03-04T12:00:00Z"
  }
}

GET/api/v1/drip/:id

Get a drip sequence with all its steps.

Response

{
  "data": {
    "id": "drip_x7k9m2",
    "name": "Welcome Series",
    "status": "active",
    "steps": [
      {
        "id": "step_a1b2c3",
        "name": "Day 1 — Welcome",
        "delayDays": 0,
        "subjectLine": "Welcome to Acme!"
      },
      {
        "id": "step_d4e5f6",
        "name": "Day 3 — Tips",
        "delayDays": 3,
        "subjectLine": "3 tips to get started"
      }
    ]
  }
}

PUT/api/v1/drip/:id

Update a drip sequence. Use this to activate, pause, or modify sequence details.

Parameters

Name	Type	Description
`status`	string	"active", "paused", or "draft"
`name`	string	Updated display name
`description`	string	Updated description

Example

curl -X PUT https://app.clawdmail.ai/api/v1/drip/drip_x7k9m2 \
  -H "Authorization: Bearer cm_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{ "status": "active" }'

Response

{
  "data": {
    "id": "drip_x7k9m2",
    "name": "Welcome Series",
    "status": "active"
  }
}

DELETE/api/v1/drip/:id

Delete a drip sequence and all its steps. Active sequences must be paused before deletion.

Response

{
  "data": {
    "success": true
  }
}

POST/api/v1/drip/:id/steps

Add a step to a drip sequence. Steps execute in order with configurable delays between them.

Parameters

Name	Type	Description
`name`required	string	Display name for this step
`delayDays`	number	Days to wait after the previous step before sending (default: 0)
`subjectLine`	string	Email subject line for this step

Response

{
  "data": {
    "id": "step_g7h8i9",
    "name": "Day 7 — Case Study",
    "delayDays": 4,
    "subjectLine": "See how Acme helped 10x growth",
    "order": 3
  }
}

POST/api/v1/drip/:id/enroll

Enroll subscribers into a drip sequence. They will begin receiving steps starting from step 1.

Response

{
  "data": {
    "enrolled": 350,
    "skipped": 12,
    "sequenceId": "drip_x7k9m2"
  }
}

POST/api/v1/drip/:id/share

Generate a shareable preview link for the drip sequence. Useful for review before activation.

Response

{
  "data": {
    "url": "https://app.clawdmail.ai/share/drip_x7k9m2?token=preview_abc123",
    "expiresAt": "2026-03-11T12:00:00Z"
  }
}