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.

Tool: add_lead_group_to_sequence

Enrolling is NOT an immediate send: the first touch waits out a 30-minute grace window by default (start_delay_minutes), and outreach paces at ~20-30 sends/day per seat, so a batch drains over days - copy stays editable until each send actually dispatches (update_lead_messages; remove_from_sequence cancels the rest). Enroll now with best-available copy and personalize in that window rather than stalling.

Parameters

Param	Type	Required	Description
`sequence_id`	string (slug or UUID)	yes	Alias: `campaign_id`.
`lead_group_id`	string (slug or UUID)	no	Enroll the group's remaining members.
`people`	string[] (person ids)	no	OR a named list of people. Alias: `person_ids`. A single id is auto-wrapped.
`where`	object	no	Filter to narrow which group members enroll.
`angle`	string	no	Variant id / label for copy attribution. Alias: `selected_angle`.
`message_overrides`	object	no	`{by_step, by_person, angle}` copy overrides. Alias: `overrides`.
`connected_account_id`	string (slug or UUID)	no	Single sender seat. Alias: `account_id`. Mutually exclusive with `connected_account_ids`.
`connected_account_ids`	string[] (slug or UUID)	no	Even split across these seats (deterministic). Mutually exclusive with `connected_account_id`. Fails if any listed seat cannot accept this sequence under the concurrent-sequence ceiling.
`start_delay_minutes`	integer	no	Grace before the first send becomes due. Default: 30 (settings). `0` = due on the next drip tick.

Per-person missing_variables failures land in failed[] - the rest of the group still enrolls.

Already-enrolled and do-not-contact people are skipped and reported.

The whole batch shares one first_send_at deadline - personalize with update_lead_messages or stop with remove_from_sequence before then.

Multi-seat enroll reports account_counts and per-row connected_account_id.

Sample request — success

{
  "sequence_id": "founder-outreach-0016",
  "lead_group_id": "ceo-prospects-0010",
  "angle": "soft",
  "start_delay_minutes": 30
}

Sample request — multi seat

{
  "sequence_id": "revops-outreach-0018",
  "lead_group_id": "revops-enroll-demo-0019",
  "connected_account_ids": [
    "jordan-sender-0001",
    "sarah-revops-0017"
  ],
  "start_delay_minutes": 30
}

Add lead group to sequence

Parameters

Sample request — success

Sample request — multi seat

On this page