GET /v1/sender-accounts — List All Sender Accounts

Use this endpoint to retrieve every sending identity connected to your workspace. Each sender account represents a single email address Leadterra uses to dispatch outbound mail on your behalf. You can check a sender’s current status before assigning it to a campaign or pool.

GET /v1/sender-accounts

Authorization

All requests must include a Bearer token in the Authorization header. You can find your API key in the Leadterra dashboard under Settings → API Keys.

Request Parameters

This endpoint accepts no query parameters, path parameters, or request body.

Example Request

curl --request GET \
  --url https://app.leadterra.co/v1/sender-accounts \
  --header "Authorization: Bearer sk_live_YOUR_KEY" \
  --header "Content-Type: application/json"

Response Fields

The response is a JSON array. Each element in the array represents one sender account.

string

Unique identifier for the sender account (e.g., sa_01HXYZ).

string

The email address used as the From address when sending mail.

string

Human-readable display name shown in the From header (e.g., "Alex Rivera").

string

Current operational state of the sender account. One of active or paused. Only active accounts can send mail.

Example Response

[
  {
    "id": "sa_01HXYZ001",
    "email": "alex.rivera@acme.io",
    "name": "Alex Rivera",
    "status": "active"
  },
  {
    "id": "sa_01HXYZ002",
    "email": "morgan.lee@acme.io",
    "name": "Morgan Lee",
    "status": "paused"
  }
]

Error Codes

HTTP Status	Code	Meaning
`400 Bad Request`	`invalid_request`	The request was malformed or contained unexpected parameters.
`401 Unauthorized`	`authentication_failed`	The `Authorization` header is missing, malformed, or the key is invalid.
`404 Not Found`	`workspace_not_found`	No workspace is associated with the provided API key.

Sender Infrastructure

Campaigns

Leads & Replies

SDR Workspace

Webhooks

GET /v1/sender-accounts — List All Sender Accounts

Authorization

Request Parameters

Example Request

Response Fields

Example Response

Error Codes

​Authorization

​Request Parameters

​Example Request

​Response Fields

​Example Response

​Error Codes

Authorization

Request Parameters

Example Request

Response Fields

Example Response

Error Codes