Sequence Tools

Create and manage multi-step communication sequences (drip campaigns, onboarding flows, re-engagement series). 5 tools in this category.

sequences.list

List all sequences with optional filtering.

Roles: ALL_ROLES

Field	Type	Required	Description
`brandId`	`uuid`	No	Filter by brand
`status`	`enum(active\|draft\|paused\|archived)`	No	Filter by status
`limit`	`integer`	No	Max results (default 20)


{
  "tool": "sequences.list",
  "input": {
    "brandId": "brand-uuid",
    "status": "active"
  }
}

sequences.get

Get sequence details including all steps and their configuration.

Roles: ALL_ROLES

Field	Type	Required	Description
`sequenceId`	`string`	Yes	Sequence identifier


{
  "tool": "sequences.get",
  "input": {
    "sequenceId": "seq_abc123"
  }
}

sequences.create

Create a new sequence.

Roles: MARKETING_AND_ADMIN | draftByDefault: true

Field	Type	Required	Description
`name`	`string`	Yes	Sequence name
`brandId`	`uuid`	Yes	Brand identifier
`trigger`	`object`	Yes	Trigger condition (event type or manual)
`trigger.type`	`enum(event\|manual)`	Yes	Trigger type
`trigger.eventName`	`string`	No	Event name (required if type is `event`)
`description`	`string`	No	Sequence description


{
  "tool": "sequences.create",
  "input": {
    "name": "New Customer Onboarding",
    "brandId": "brand-uuid",
    "trigger": {
      "type": "event",
      "eventName": "lead.captured.v1"
    },
    "description": "Welcome series for new leads from VSL forms"
  }
}

sequences.add_step

Add a step to an existing sequence.

Roles: MARKETING_AND_ADMIN

Field	Type	Required	Description
`sequenceId`	`string`	Yes	Sequence identifier
`type`	`enum(send\|delay\|condition\|webhook)`	Yes	Step type
`templateId`	`string`	No	Template to send (required for `send` type)
`delayMinutes`	`integer`	No	Delay in minutes (required for `delay` type)
`condition`	`object`	No	Branch condition (required for `condition` type)
`position`	`integer`	No	Step position (appended if omitted)


{
  "tool": "sequences.add_step",
  "input": {
    "sequenceId": "seq_abc123",
    "type": "send",
    "templateId": "tpl_welcome01"
  }
}


{
  "tool": "sequences.add_step",
  "input": {
    "sequenceId": "seq_abc123",
    "type": "delay",
    "delayMinutes": 1440
  }
}

sequences.simulate

Simulate sequence execution for a specific person or audience to preview timing and content.

Roles: ALL_ROLES

Field	Type	Required	Description
`sequenceId`	`string`	Yes	Sequence identifier
`personId`	`uuid`	No	Simulate for a specific person
`startAt`	`datetime`	No	Simulated start time (default now)


{
  "tool": "sequences.simulate",
  "input": {
    "sequenceId": "seq_abc123",
    "personId": "person-uuid",
    "startAt": "2026-05-20T09:00:00Z"
  }
}