List sending mailboxes

curl --request GET \
  --url https://client-api.salesfinity.co/v2/sequencer/email-accounts \
  --header 'x-api-key: <api-key>'

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

fetch('https://client-api.salesfinity.co/v2/sequencer/email-accounts', 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/email-accounts",
  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/email-accounts"

	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/email-accounts")

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

{
  "data": [
    {
      "id": 48215,
      "from_name": "Dana Reyes",
      "from_email": "[email protected]",
      "domain": "yourcompany.com",
      "type": "GMAIL",
      "is_paused": false,
      "is_connected": true,
      "can_send": true,
      "assigned_to": {
        "id": "64b7f0c2e4b0a1b2c3d4e5f1",
        "name": "Dana Reyes"
      },
      "warmup_status": "ACTIVE",
      "warmup_reputation": "100%",
      "smtp_failure": null,
      "imap_failure": null,
      "message_per_day": 40,
      "daily_sent_count": 12,
      "campaign_count": 3,
      "tags": [
        {
          "id": 311,
          "name": "Outbound",
          "color": "#7F56D9"
        }
      ],
      "deliverability": {
        "status": "healthy",
        "reason": "SPF, DKIM, DMARC and MX all check out."
      },
      "created_at": "2026-08-21T09:14:00.000Z"
    }
  ],
  "pagination": {
    "total": 1,
    "page": 1,
    "limit": 25,
    "pages": 1
  },
  "provisioned": true,
  "summary": {
    "total": 1,
    "ready": 1,
    "warming": 1,
    "not_connecting": 0,
    "paused": 0,
    "out_of_pool": 0,
    "sent_today": 12,
    "daily_capacity": 40
  }
}

{
  "message": [
    "limit must not be greater than 200"
  ],
  "error": "Bad Request",
  "statusCode": 400,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "An active plan or seat is required to use this feature. Please upgrade your plan or ask your team admin to assign you a seat.",
  "error": "NO_ACTIVE_PLAN",
  "statusCode": 403,
  "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"
}

Settings and mailboxes

List sending mailboxes

Returns the team’s sending mailboxes with connection health, warmup state, today’s usage and who each belongs to, plus fleet-wide counts in summary.

A sequence with an email step can be enabled only when a mailbox in its own sending pool is ready (can_send true, is_paused false and is_connected true). The pool is the sequence’s email_account_ids if set, otherwise the mailboxes assigned to its author, otherwise the team’s shared mailboxes.

Paging. Send page or limit (1 to 200, default 25) to page through the list. With no query parameters at all, data holds every mailbox in one response, even when pagination reports more than one page.
Filters combine and apply before paging. summary always counts the whole fleet, not the filtered set.
Not provisioned. provisioned: false with an empty data means the team has no sending account yet; one is created when the first mailbox is connected or the first email sequence is enabled. provisioned: true with an empty data means no mailbox is connected.

Credentials are never returned; the fields are an allowlist. Mailboxes are connected and managed in the dashboard on the Mailboxes page. Reads the sending provider live, so it is slower than other reads, and it requires the team owner, whom reads act as, to have an active plan or seat. Counts against the Sequencer reads rate limit.

GET

sequencer

email-accounts

List sending mailboxes

curl --request GET \
  --url https://client-api.salesfinity.co/v2/sequencer/email-accounts \
  --header 'x-api-key: <api-key>'

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

fetch('https://client-api.salesfinity.co/v2/sequencer/email-accounts', 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/email-accounts",
  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/email-accounts"

	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/email-accounts")

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

{
  "data": [
    {
      "id": 48215,
      "from_name": "Dana Reyes",
      "from_email": "[email protected]",
      "domain": "yourcompany.com",
      "type": "GMAIL",
      "is_paused": false,
      "is_connected": true,
      "can_send": true,
      "assigned_to": {
        "id": "64b7f0c2e4b0a1b2c3d4e5f1",
        "name": "Dana Reyes"
      },
      "warmup_status": "ACTIVE",
      "warmup_reputation": "100%",
      "smtp_failure": null,
      "imap_failure": null,
      "message_per_day": 40,
      "daily_sent_count": 12,
      "campaign_count": 3,
      "tags": [
        {
          "id": 311,
          "name": "Outbound",
          "color": "#7F56D9"
        }
      ],
      "deliverability": {
        "status": "healthy",
        "reason": "SPF, DKIM, DMARC and MX all check out."
      },
      "created_at": "2026-08-21T09:14:00.000Z"
    }
  ],
  "pagination": {
    "total": 1,
    "page": 1,
    "limit": 25,
    "pages": 1
  },
  "provisioned": true,
  "summary": {
    "total": 1,
    "ready": 1,
    "warming": 1,
    "not_connecting": 0,
    "paused": 0,
    "out_of_pool": 0,
    "sent_today": 12,
    "daily_capacity": 40
  }
}

{
  "message": [
    "limit must not be greater than 200"
  ],
  "error": "Bad Request",
  "statusCode": 400,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "An active plan or seat is required to use this feature. Please upgrade your plan or ask your team admin to assign you a seat.",
  "error": "NO_ACTIVE_PLAN",
  "statusCode": 403,
  "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 mailboxes a team sends from, with their health and today’s usage. Check it before enabling a sequence with an email step: at least one mailbox in that sequence’s sending pool must be ready. The pool is the sequence’s email_account_ids if set, otherwise the mailboxes assigned to its author, otherwise the team’s shared mailboxes.

Common queries

You want	Query parameters
Mailboxes that can send now	`status=ready`
Mailboxes that need reconnecting	`status=not_connecting`
One rep’s mailboxes	`assigned_to=REP_ID`
The shared pool	`shared=true`

Good to know

A mailbox is ready when can_send is true, is_paused is false and is_connected is true. can_send alone only means it is in the pool or assigned to a rep.
Send page or limit to page through the list. With no query parameters, data holds every mailbox in one response, even when pagination reports more than one page.
summary counts the whole fleet whatever the filter, and its counts overlap: a mailbox can be both ready and warming.
provisioned: false means the team has no sending account yet. It is created when the first mailbox is connected or the first email sequence is enabled.
Mailboxes are connected and managed in the dashboard on the Mailboxes page. This API does not connect or remove them.

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.

Query Parameters

string

Case-insensitive match on the sender name, address or domain. At most 200 characters.

Maximum string length: 200

status

enum<string>

ready: can send now (can_send true, not paused, connected). not_connecting: SMTP or IMAP failed on the last check, so its credentials need fixing. paused: paused on purpose. out_of_pool: neither in the shared pool nor assigned to a rep, so nothing sends from it.

Available options:

ready,

not_connecting,

paused,

out_of_pool

warmup

enum<string>

on: warmup is running (warmup_status is ACTIVE). off: it is not.

Available options:

on,

off

esp

string

Mailbox type, matched exactly: GMAIL, OUTLOOK or SMTP. At most 40 characters.

Maximum string length: 40

tag_id

number

Only mailboxes carrying this tag (a numeric id from tags).

shared

boolean

true: only mailboxes in the shared team pool (can_send and assigned to nobody). false: every other mailbox.

assigned_to

string

A team member id for that rep's mailboxes, or unassigned for mailboxes no rep owns. At most 64 characters.

Maximum string length: 64

page

number

Page number, 1-based, up to 10,000. Sending it turns paging on.

Required range: 1 <= x <= 10000

limit

number

Results per page. Default 25 once paging is on. Above 200 is treated as 200.

Required range: 1 <= x <= 200

Response

The mailboxes.

Mailboxes in the standard list envelope, plus whether the team has a sending account at all and fleet-wide counts.

data

object[]

required

Show child attributes

pagination

object

required

Pagination for the paged lists under /v2/sequencer. Every paged list uses this one shape; a few short lists (a sequence's steps, the team's policies, a task's events and enrollment runs) return a plain array instead.

Show child attributes

provisioned

boolean

required

False means the team has no sending account yet, which is a different state from a provisioned team with no mailboxes connected. Both return an empty data.

summary

object

Counts across the whole fleet rather than the current filter, so they stay usable as the way out of a filter. The status counts overlap: a mailbox can be both ready and warming. Absent on an unprovisioned team.

Show child attributes

Get started

MCP server

MCP reference

MCP use cases

Dialer API

Calls and analytics API

Enrichment API

Sequencer API

List sending mailboxes

Common queries

Good to know

Authorizations

Query Parameters

Response

​Common queries

​Good to know

Authorizations

Query Parameters

Response

Common queries

Good to know