Requires the Tasks permission. Tools in this group are hidden from
tools/list and refused on call when your plan does not grant it.appointment_get
Read-only Full detail for one booked meeting: time, timezone, status, and the lead and conversation it came out of. Read-only, likeappointment_list — rescheduling and cancelling happen in the web app.
Parameters
string
required
Appointment id, from
appointment_list.appointment_list
Read-only Meetings booked out of conversations, or created in the web app. Read-only here by design: appointments are never inserted or edited by hand over this server, so there is no tool to create, change or cancel one. For the thread a meeting came out of useconversation_get.
Parameters
string
Lead id, from
lead_list.string
Conversation id, from
conversation_list.CONFIRMED | CANCELLED | RESCHEDULED | NO_SHOW | COMPLETED
Filter by status.
integer (min 1)
default:"1"
1-indexed page number.
reminder_create
Write Set a follow-up reminder on a lead or conversation. You are notified atremindAt — you, not the prospect; nothing is sent to them. It does not schedule a campaign step or delay one. To make a lead wait, use lead_update with paused. Cancel with reminder_delete.
Parameters
string
required
Short label.
string | number
required
When to fire, epoch milliseconds or ISO 8601.
string
Longer explanatory text.
string
Lead id, from
lead_list.string
Conversation id, from
conversation_list.string
LinkedIn account id, from
linkedin_account_list.reminder_delete
Write Destructive Cancel a reminder so it never fires. Does not affect the lead, the conversation, or any scheduled campaign step — only your own nudge goes away. One of the few deletions available here, and it destroys nothing a prospect sees. To close a to-do instead usetask_upsert with isCompleted.
Parameters
string
required
Reminder id, from
reminder_list.reminder_list
Read-only Follow-up reminders set on a conversation or a lead. Private nudges for your team at a point in time. They send nothing to the prospect and are unrelated to the campaign schedule, which iscampaign_update.
Parameters
string
Conversation id, from
conversation_list.string
Lead id, from
lead_list.task_list
Read-only Manual to-dos for your team, either across your whole account or for one lead. TASK steps in a campaign flow create these automatically. Work for a human, not sending steps: a pending campaign action isactivity_list or lead_flow_state, and a dated nudge is reminder_list. Completing a task sends nothing.
Parameters
string
Only tasks attached to this lead.
string
LinkedIn account id, from
linkedin_account_list.string
Mailbox id, from
email_account_list.integer (min 1)
default:"1"
1-indexed page number.
task_upsert
Write Create a to-do, or update one by passingtaskId. Set isCompleted: true to close it. An internal note-to-self with an owner; nothing is sent to the prospect and no campaign step is affected. For a timed personal nudge use reminder_create.
Parameters
string
Omit to create a new task.
string
required
What needs doing.
string
Detail or context.
string
Lead this relates to.
string
Conversation id, from
conversation_list.string
Related URL.
string
Free-text label for grouping.
string | number
Due date, epoch milliseconds or ISO 8601.
boolean
Mark as done.
