Add to sequence
Enroll one person in a sequence with per-lead angle and message copy.
Tool: add_to_sequence
Enrolling is NOT an immediate send: the first touch is queued after start_delay_minutes and copy stays editable until dispatch via update_lead_messages - enroll with best-available copy rather than stalling on perfect personalization.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
sequence_id | string (slug or UUID) | yes | Alias: campaign_id. |
person_id | string (slug or UUID) | yes | The one lead to enroll. |
angle | string | no | Messaging angle (defaults to the sequence default_angle). Alias: selected_angle. |
message_overrides | object | no | {by_step: {step_id: message}} per-lead copy. Alias: overrides. |
messages | object | no | Shorthand alias for message_overrides.by_step. |
connected_account_id | string (slug or UUID) | no | Sender seat. Alias: account_id. |
start_delay_minutes | integer | no | Grace before the first send becomes due. Default: 30 (settings). 0 = due on the next drip tick. |
Refuses with
missing_variableswhen a person has no value for a template variable the sequence uses (checked against the copy each step would actually send; a literal message override rescues a sparse person).Rejects a person who already has an active enrollment.
Sample request — success
{
"sequence_id": "founder-outreach-0023",
"person_id": "priya-sharma-0003",
"angle": "direct",
"message_overrides": {
"by_step": {
"invite": "Hi Priya — big fan of Acme."
}
}
}Sample request — with grace
{
"sequence_id": "founder-outreach-0023",
"person_id": "sam-reyes-0007",
"start_delay_minutes": 45
}Add lead group to sequence
Enroll a lead group (or people list) in a sequence with the same fixed messages for everyone - use add_to_sequence per person to personalize copy.
Create sequence
Create a sequence from an ordered steps array (typically a connection request, an acceptance condition, then 3–4 spaced follow-up messages).