Queue instantly handoffs
queue_instantly_handoffsA prospect no longer waiting on the step, already handed off on it, or removed from the
campaign is skipped. A prospect whose address bounced or was unsubscribed from the user's
emails, or who has no stored address, is blocked on the step instead.
A dict with queued, one entry per handed-off prospect with its prospect_id and
status ('pending_approval' while it waits on the user, else 'pending'), and skipped
and blocked, one entry per prospect left out with its prospect_id and reason.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"agent_id": "<agent_id>",
"node_id": "<node_id>",
"prospect_ids": "<prospect_ids>"
},
"name": "queue_instantly_handoffs"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| node_id | Yes | The Instantly step's node id. | |
| agent_id | Yes | ID of the agent (campaign) whose flow has the Instantly step. | |
| on_behalf_of | No | A teammate's email, or an agency client's from list_agency_clients, to run this call in that account: their agents, settings, connected accounts, and credits. Omit it to act on your own account. | |
| prospect_ids | Yes | The prospects to hand off, by `id` — the outreach_prospects primary key, as returned on every query_prospects row and shown on a flow roster line. |