Skip to main content

Get sender account

Get one sender account visible to the authenticated actor and its active delegation records.

GET/api/sender-accounts/{sender_account_id}
HTTP referenceScope integrations:readUpdated June 3, 2026

This page documents the canonical HTTP contract for this endpoint.

Resolution uses the send scope: the actor must own the account, have an active send delegation, or be an admin. Read-only delegations do not qualify. For managed-fleet accounts, platform assignment/access rules still apply to admins. If a nonempty capabilities list is present, the account must include send; otherwise the endpoint returns 409. Ordinary account connection status does not have to be ready for inspection; managed-fleet accounts also require current allocation and mailbox access.

Only active (not revoked) delegations are included. The example is abbreviated; account and delegation records can contain additional fields.

Path parameters

  • sender_account_idrequired

    string

    Sender account ID.

Errors

StatusMeaning
401Authentication failed or the actor/organization context is unavailable.
403The actor lacks the required send access to this sender account.
404Sender account not found.
409The sender account does not support the required send scope.

Docs