ToolsSequences
Update lead messages
Personalize an ENROLLED lead's copy - merges per-step message overrides (and angle) and re-personalizes the queued unsent send in place.
Tool: update_lead_messages
Future steps pick the new copy up automatically. NOT for: pre-enrollment copy → pass messages on add_to_sequence.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
person_id | string (slug or UUID) | yes | Must have an active enrollment. |
messages | object | no | {step_id: body} per-step copy - validated against the sequence's step ids. Alias: message_overrides.by_step. |
angle | string | no | Switch the messaging angle. |
sequence_id | string (slug or UUID) | no | Disambiguate if ever multi-enrolled. |
Personalizes copy after enrolling: the currently queued unsent send is re-personalized in place (same schedule, same idempotency key); future steps pick the new copy up when they materialize; already-sent steps are reported and left alone (
too_latewhen nothing is editable).
Sample request
{
"person_id": "priya-sharma-0003",
"messages": {
"follow_up": "Hi {{first_name}} — following up; loved your PLG onboarding post."
}
}