Skip to main content
GET
Get a sending mailbox
One mailbox’s connection health, warmup status and today’s usage against its daily cap.

Good to know

  • This returns fewer fields than List sending mailboxes. assigned_to, domain, tags, warmup_reputation, campaign_count, deliverability and created_at are only on the list.
  • Mailbox ids are numbers from the list’s id, not 24-character ids.
  • An id that is not one of the team’s mailboxes returns 400 (Could not load this mailbox. Try again in a moment.), not 404.
  • When is_connected is false, smtp_failure and imap_failure carry the mail server’s own error message.

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
number
required

Numeric mailbox id, from id on the list. Mailboxes come from the sending provider, so these are not 24-character ids.

Response

The mailbox.

A sending mailbox. Credentials are never returned. GET /v2/sequencer/email-accounts/{id} returns only id, from_name, from_email, type, is_paused, is_connected, can_send, warmup_status, smtp_failure, imap_failure, message_per_day and daily_sent_count; the list returns every field below.

id
integer

Numeric mailbox id, from the sending provider.

from_name
string | null
from_email
string | null
domain
string

Domain of from_email, lowercased. List only.

type
string

GMAIL, OUTLOOK or SMTP.

is_paused
boolean

Paused on purpose by a person.

is_connected
boolean

SMTP and IMAP both answered on the last check. False means the credentials stopped working and the mailbox needs reconnecting.

can_send
boolean

Someone can send from it: it is in the shared team pool or assigned to a rep. It does not mean healthy; a mailbox is ready when can_send is true, is_paused is false and is_connected is true.

warmup_status
string | null

The sending provider's warmup status, for example ACTIVE while warmup runs.

warmup_reputation
string | null

The provider's warmup verdict, for example 100%. Often null on a new mailbox. List only.

smtp_failure
string | null

The mail server's error when sending is failing.

imap_failure
string | null

The mail server's error when reading replies is failing.

daily_sent_count
integer | null

Emails sent today.

message_per_day
integer | null

Daily sending cap.

campaign_count
integer

How many sequences currently send through it. List only.

tags
object[]

Provider-side tags. List only.

assigned_to
object | null

The rep the mailbox belongs to (id, name), or null when it is shared or unused. List only.

deliverability
object

Domain authentication verdict (SPF, DKIM, DMARC, MX). Absent when the check has not run. List only.

created_at
string

When the mailbox was connected. List only.