Skip to main content
GET
Get a task
One task with what is needed to work it: the contact (name, company, title, phone numbers, timezone and CRM facts), the sequence’s name, and the step, including its task note.

Good to know

  • user is the assignee’s id here. List tasks returns it expanded.
  • A manual_email task’s drafted email is in body. While a send is in flight sending_claimed_at is set, and if the last send failed error_reason says why.
  • For the task’s history, see List task events. For a task from a sequence, the enrollment timeline is more complete.

Authorizations

x-api-key
string
header
required

Team-scoped API key generated in the Salesfinity dashboard under Settings → Connections → API & Webhooks. A missing or invalid key returns HTTP 403.

Path Parameters

id
string
required

24-character task id.

Response

The task.

A task in a rep's queue. contact, sequence, sequence_step and user are documented as ids, but responses expand some of them into objects, as each property says.

_id
string

24-character hexadecimal id.

Example:

"507f1f77bcf86cd799439011"

team
string

Team id.

user
string

Assignee, as a team member id. GET /v2/sequencer/tasks with the default sort=due expands it to an object with _id, first_name, last_name, email and image.

contact
string

The contact the task is about. Every task response expands it to an object: _id plus whichever of these are set: first_name, last_name, email, linkedin_username, account (company), account_key, title, phone_numbers, timezone, website, email_domain, last_touched_at, last_touch, channel_stats, crm_facts.

sequence
string | null

The sequence that created the task. Absent on a one-off task. Every task response expands it to _id and name.

sequence_state
string | null

The enrollment the task belongs to. Absent on a one-off task.

sequence_step
string | null

The step that created the task. Absent on a one-off task. GET /v2/sequencer/tasks expands it to _id, order, step_type and display_name, and GET /v2/sequencer/tasks/{id} adds task_note; other responses return the id.

origin
enum<string>

sequence: created by a sequence step or a reaction. one_off: created by a rep.

Available options:
sequence,
one_off
created_by
string

Who created a one-off task. Absent on sequence tasks.

standalone
boolean

True for tasks outside the cadence: every one-off task, and to-dos a reaction created. Completing or skipping one never moves an enrollment.

action
enum<string>

What the task asks for. Sequence steps create call, manual_email and generic; the LinkedIn actions, meeting and sms occur only on one-off tasks.

Available options:
call,
manual_email,
generic,
linkedin_connect,
linkedin_message,
linkedin_view,
linkedin_interact,
meeting,
sms
state
enum<string>

pending: open. held: waiting while the enrollment is paused; it cannot be completed or skipped until it returns to pending. completed and skipped: resolved by a person. expired: skipped automatically at autoskip_at. cancelled: withdrawn, because the enrollment ended underneath it or a one-off task was cancelled.

Available options:
pending,
held,
completed,
skipped,
expired,
cancelled
priority
enum<string>

Priority band, copied from the step or set on a one-off task.

Available options:
high,
medium,
low
subject
string | null

Short title: the step's display name on a sequence task, or what the creator entered on a one-off task.

note
string | null

Instructions for the rep: the step's task note, or the one-off task's note. A note sent on completion replaces it.

body
string

The drafted email of a manual_email task, rendered when the step came due, or the body sent on completion.

due_at
string<date-time>

When the task is due.

autoskip_at
string<date-time> | null

When an untouched task is skipped automatically, moving to expired. Set from the step's auto-skip delay; absent when the step has none.

completed_at
string<date-time> | null

When the task was completed or skipped.

held_at
string<date-time> | null

When the task went held with its paused enrollment; null otherwise.

call_log
string | null

The call that resolved a call task: from a disposition in the dialer, or from call_log on complete.

outcome_applied_at
string<date-time> | null

When the outcome of the call that resolved this task was applied to the enrollment.

contact_list
string | null

The Sequencer dial list a pending call task is placed on; null or absent when it is not on one.

contact_list_item
string | null

The task's row in that dial list.

sending_claimed_at
string<date-time> | null

Set while the email of a manual_email task is being sent. The task stays pending until the send is confirmed; a failed send clears this.

error_reason
string

Why the last send of a manual_email task failed. Cleared when a new send starts.

created_at
string<date-time>
updated_at
string<date-time>