Skip to main content
Access: Connect (full). See Access control.

list_tasks

List tasks, or get a specific task by ID. When taskId is provided, returns detailed task info including status, contact, and campaign details. Otherwise returns a paginated table of tasks with optional filters. Aggregate counts are in counts.

Arguments

integer | string
ID of a specific task to retrieve. Omit to list all.
integer | string
Filter tasks by campaign ID (only used when listing).
string
Filter tasks by campaign identifier (slug). Use instead of campaignId when you already have the identifier; takes precedence if both are given.
string
Filter by task status.One of: scheduled, in-progress, completed, paused, errored, cancelled, skipped.
string
Filter by task type.One of: manual-email, auto-email, call, linkedIn, linkedin-message, linkedin-connect-request, custom.
string
Opaque token from pagination.nextCursor
integer
Page size (default 25). Must match the first page’s when cursor is set
string
default:"createdAt"
Column to sort by (default “createdAt”).
string
default:"desc"
Sort direction (default “desc”).One of: asc, desc.

Result

Returns a text content block and a structuredContent object with these fields. Treat every field as nullable: a value the record does not have comes back as null.
object[]
Result records when listingFields vary by record.
object
Pagination metadata when available. Carries only the values the service has, so treat a missing key as unknown rather than zero; nextCursor is null or absent on the last page.
object | null
Aggregate counts describing the whole result set, where a tool reports themFields vary by record.

start_task

Run a to-do or scheduled task now. For an automatic email task this sends the email immediately. Confirm with the user before calling. Returns the task ID and the action taken.
May overwrite, remove, or send data in a way that cannot be undone. Ask for explicit confirmation before calling this tool in an agent workflow.

Arguments

integer | string
required
The ID of the task (from list_tasks).

Result

Returns a text content block describing the outcome, plus a structuredContent object that mirrors it. This tool publishes no outputSchema, so the object’s fields are not guaranteed; treat every field as optional and nullable.

pause_task

Pause a to-do, scheduled, or errored task so it does not run until it is unpaused with unpause_task. Returns the task ID and the action taken.
May overwrite, remove, or send data in a way that cannot be undone. Ask for explicit confirmation before calling this tool in an agent workflow.

Arguments

integer | string
required
The ID of the task (from list_tasks).

Result

Returns a text content block describing the outcome, plus a structuredContent object that mirrors it. This tool publishes no outputSchema, so the object’s fields are not guaranteed; treat every field as optional and nullable.

unpause_task

Unpause a paused task so it is due again. A campaign email task can send once it is due. Confirm with the user before calling. Returns the task ID and the action taken.
May overwrite, remove, or send data in a way that cannot be undone. Ask for explicit confirmation before calling this tool in an agent workflow.

Arguments

integer | string
required
The ID of the task (from list_tasks).

Result

Returns a text content block describing the outcome, plus a structuredContent object that mirrors it. This tool publishes no outputSchema, so the object’s fields are not guaranteed; treat every field as optional and nullable.

complete_task

Mark a to-do, paused, scheduled, or errored task as completed, for example after the user made the call or did the work themselves. This does not send anything. Returns the task ID and the action taken.
May overwrite, remove, or send data in a way that cannot be undone. Ask for explicit confirmation before calling this tool in an agent workflow.

Arguments

integer | string
required
The ID of the task (from list_tasks).

Result

Returns a text content block describing the outcome, plus a structuredContent object that mirrors it. This tool publishes no outputSchema, so the object’s fields are not guaranteed; treat every field as optional and nullable.

skip_task

Skip a to-do, paused, pending, scheduled, or errored task so it is not done for this contact. Confirm with the user before calling. Returns the task ID and the action taken.
May overwrite, remove, or send data in a way that cannot be undone. Ask for explicit confirmation before calling this tool in an agent workflow.

Arguments

integer | string
required
The ID of the task (from list_tasks).

Result

Returns a text content block describing the outcome, plus a structuredContent object that mirrors it. This tool publishes no outputSchema, so the object’s fields are not guaranteed; treat every field as optional and nullable.

cancel_task

Cancel a task that has not finished, so it never runs. Confirm with the user before calling. Returns the task ID and the action taken.
May overwrite, remove, or send data in a way that cannot be undone. Ask for explicit confirmation before calling this tool in an agent workflow.

Arguments

integer | string
required
The ID of the task (from list_tasks).

Result

Returns a text content block describing the outcome, plus a structuredContent object that mirrors it. This tool publishes no outputSchema, so the object’s fields are not guaranteed; treat every field as optional and nullable.

create_task

Create a standalone task (email, call, or custom action) for a contact. This is separate from campaign steps — use create_campaign_step for campaign workflows. Returns the created task with its ID.

Arguments

string
required
Name/title of the task.
string
required
Type of task: “manual-email” for email tasks, “call” for phone tasks, “action-item” for custom tasks, “linkedin” for LinkedIn tasks.One of: manual-email, call, action-item, linkedin.
integer | string
The saved contact ID to associate with (from get_my_contacts).
string
Due date in ISO 8601 format.
string
Task description or notes.
integer
default:"0"
Priority level: 0=normal, 1=high, 2=urgent.
integer | string
Template ID for email tasks.

Result

Returns a text content block describing the outcome, plus a structuredContent object that mirrors it. This tool publishes no outputSchema, so the object’s fields are not guaranteed; treat every field as optional and nullable.

Example

update_task

Update an existing task. Modify its name, due date, description, priority, or status. Returns the updated task.
May overwrite, remove, or send data in a way that cannot be undone. Ask for explicit confirmation before calling this tool in an agent workflow.

Arguments

integer | string
required
The ID of the task to update.
string
Updated task name.
string
Updated due date in ISO 8601 format.
string
Updated description or notes.
integer
Updated priority level.
string
Updated status (e.g. todo, completed).

Result

Returns a text content block describing the outcome, plus a structuredContent object that mirrors it. This tool publishes no outputSchema, so the object’s fields are not guaranteed; treat every field as optional and nullable.

delete_task

Permanently delete a task. This cannot be undone. Use list_tasks to find task IDs.
May overwrite, remove, or send data in a way that cannot be undone. Ask for explicit confirmation before calling this tool in an agent workflow.

Arguments

integer | string
required
The ID of the task to delete.

Result

Returns a text content block describing the outcome, plus a structuredContent object that mirrors it. This tool publishes no outputSchema, so the object’s fields are not guaranteed; treat every field as optional and nullable.