List task events

curl --request GET \
  --url https://client-api.salesfinity.co/v2/sequencer/tasks/{id}/events \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://client-api.salesfinity.co/v2/sequencer/tasks/{id}/events', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://client-api.salesfinity.co/v2/sequencer/tasks/{id}/events",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://client-api.salesfinity.co/v2/sequencer/tasks/{id}/events"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://client-api.salesfinity.co/v2/sequencer/tasks/{id}/events")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

[
  {
    "_id": "66fe2c10d4e5f6a7b8c9d0f3",
    "team": "64b7f0c2e4b0a1b2c3d4e5f0",
    "task": "66fe01b7c3e4b5a6d7e8fa10",
    "contact": "66f9b1e0a2c3d4e5f6a7b8c9",
    "user": {
      "_id": "64b7f0c2e4b0a1b2c3d4e5f9",
      "first_name": "Morgan",
      "last_name": "Hale",
      "email": "[email protected]"
    },
    "type": "task_reassigned",
    "occurred_at": "2026-10-03T18:05:00.000Z",
    "payload": {
      "task": "66fe01b7c3e4b5a6d7e8fa10",
      "action": "linkedin_connect",
      "from_user": "64b7f0c2e4b0a1b2c3d4e5f1",
      "to_user": "64b7f0c2e4b0a1b2c3d4e5f2",
      "note": "Covering while Dana is out"
    }
  },
  {
    "_id": "66fe01b8c3e4b5a6d7e8fa11",
    "team": "64b7f0c2e4b0a1b2c3d4e5f0",
    "task": "66fe01b7c3e4b5a6d7e8fa10",
    "contact": "66f9b1e0a2c3d4e5f6a7b8c9",
    "user": {
      "_id": "64b7f0c2e4b0a1b2c3d4e5f1",
      "first_name": "Dana",
      "last_name": "Reyes",
      "email": "[email protected]"
    },
    "type": "task_created",
    "occurred_at": "2026-10-03T16:02:11.000Z",
    "payload": {
      "task": "66fe01b7c3e4b5a6d7e8fa10",
      "action": "linkedin_connect",
      "one_off": true,
      "assigned_to": "64b7f0c2e4b0a1b2c3d4e5f1"
    }
  }
]

{
  "message": "Invalid ObjectId",
  "error": "Bad Request",
  "statusCode": 400,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Forbidden resource",
  "error": "Forbidden",
  "statusCode": 403,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Sequence task not found",
  "error": "Not Found",
  "statusCode": 404,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Rate limit of 300 requests per minute exceeded. Retry in 12s.",
  "error": "Too Many Requests",
  "statusCode": 429,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Internal server error",
  "error": "Internal Server Error",
  "statusCode": 500,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Sequencer service unreachable",
  "error": "Bad Gateway",
  "statusCode": 502,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Sequencer service timed out",
  "error": "Gateway Timeout",
  "statusCode": 504,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

Tasks

List task events

Returns the timeline rows recorded against one task, newest first: a plain array of at most 200 events, with no pagination parameters.

For a one-off task this is its whole history: created (task_created), completed (task_completed, or email_sent when a manual_email task’s email goes out), skipped (task_skipped; a cancellation is a task_skipped with payload.reason deleted), reassigned (task_reassigned), and for a call task the logged call (call_completed). For a task from a sequence it holds only what was recorded against the task itself, such as reassignments: the task’s creation, completion and skip are on the enrollment timeline, GET /v2/sequencer/enrollments/{id}/events, which is paged.

Snoozing and editing are not recorded. Each event’s user is expanded to _id, first_name, last_name and email. A longer history is cut to its 200 most recent events. Counts against the Sequencer reads rate limit.

GET

sequencer

tasks

{id}

events

List task events

curl --request GET \
  --url https://client-api.salesfinity.co/v2/sequencer/tasks/{id}/events \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://client-api.salesfinity.co/v2/sequencer/tasks/{id}/events', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://client-api.salesfinity.co/v2/sequencer/tasks/{id}/events",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://client-api.salesfinity.co/v2/sequencer/tasks/{id}/events"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://client-api.salesfinity.co/v2/sequencer/tasks/{id}/events")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

[
  {
    "_id": "66fe2c10d4e5f6a7b8c9d0f3",
    "team": "64b7f0c2e4b0a1b2c3d4e5f0",
    "task": "66fe01b7c3e4b5a6d7e8fa10",
    "contact": "66f9b1e0a2c3d4e5f6a7b8c9",
    "user": {
      "_id": "64b7f0c2e4b0a1b2c3d4e5f9",
      "first_name": "Morgan",
      "last_name": "Hale",
      "email": "[email protected]"
    },
    "type": "task_reassigned",
    "occurred_at": "2026-10-03T18:05:00.000Z",
    "payload": {
      "task": "66fe01b7c3e4b5a6d7e8fa10",
      "action": "linkedin_connect",
      "from_user": "64b7f0c2e4b0a1b2c3d4e5f1",
      "to_user": "64b7f0c2e4b0a1b2c3d4e5f2",
      "note": "Covering while Dana is out"
    }
  },
  {
    "_id": "66fe01b8c3e4b5a6d7e8fa11",
    "team": "64b7f0c2e4b0a1b2c3d4e5f0",
    "task": "66fe01b7c3e4b5a6d7e8fa10",
    "contact": "66f9b1e0a2c3d4e5f6a7b8c9",
    "user": {
      "_id": "64b7f0c2e4b0a1b2c3d4e5f1",
      "first_name": "Dana",
      "last_name": "Reyes",
      "email": "[email protected]"
    },
    "type": "task_created",
    "occurred_at": "2026-10-03T16:02:11.000Z",
    "payload": {
      "task": "66fe01b7c3e4b5a6d7e8fa10",
      "action": "linkedin_connect",
      "one_off": true,
      "assigned_to": "64b7f0c2e4b0a1b2c3d4e5f1"
    }
  }
]

{
  "message": "Invalid ObjectId",
  "error": "Bad Request",
  "statusCode": 400,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Forbidden resource",
  "error": "Forbidden",
  "statusCode": 403,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Sequence task not found",
  "error": "Not Found",
  "statusCode": 404,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Rate limit of 300 requests per minute exceeded. Retry in 12s.",
  "error": "Too Many Requests",
  "statusCode": 429,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Internal server error",
  "error": "Internal Server Error",
  "statusCode": 500,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Sequencer service unreachable",
  "error": "Bad Gateway",
  "statusCode": 502,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Sequencer service timed out",
  "error": "Gateway Timeout",
  "statusCode": 504,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

The activity recorded against one task, newest first.

What you will find

Task	Events returned
One-off task	Its whole history: `task_created`, `task_completed` (or `email_sent` for a `manual_email` task), `task_skipped`, `task_reassigned`, and `call_completed` for a call logged in the dialer. A cancellation is a `task_skipped` with `payload.reason` `deleted`.
Task from a sequence	Only events recorded against the task itself, such as `task_reassigned`. Its creation, completion and skip are on the enrollment timeline.

Good to know

At most 200 events, with no paging. A longer history is cut to the most recent 200.
Snoozes and edits are not recorded.
Each event’s user is expanded to _id, first_name, last_name and email.

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

string

required

24-character task id.

Response

At most 200 events, newest first. Not paginated.

_id

string

24-character hexadecimal id.

Example:

"507f1f77bcf86cd799439011"

type

string

What happened. List enrollment events lists every type and its payload.

occurred_at

string<date-time>

When it happened.

sequence

string | null

sequence_step

string | null

contact

string | null

payload

object | null

Type-specific detail.

team

string

ID of your team.

sequence_state

string

The enrollment the event belongs to. Absent on a one-off task's events, which belong to no sequence.

task

string

The task the event is about, when it is about one. Set on events recorded against a task, such as a reassignment; the engine's own task events on an enrollment timeline carry the task ID in payload.task instead.

user

object

Who acted, expanded to _id, first_name, last_name and email. Absent for what the engine does on its own, which is most events.

Show child attributes

external_id

string

Idempotency key for an event that came from outside Salesfinity, such as a provider webhook. Absent on events Salesfinity generates.

created_at

string<date-time>

When the event was recorded. Use occurred_at for when it happened.

updated_at

string<date-time>

Equal to created_at: events are never changed.

Get started

MCP server

MCP reference

MCP use cases

Dialer API

Calls and analytics API

Enrichment API

Sequencer API

List task events

What you will find

Good to know

Authorizations

Path Parameters

Response

​What you will find

​Good to know

Authorizations

Path Parameters

Response

What you will find

Good to know