> ## Documentation Index
> Fetch the complete documentation index at: https://docs.leadterra.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Sender Pools: Private Delivery Capacity and Identities

> Sender pools give your workspace dedicated delivery capacity and sending identities for outbound campaigns, isolated from other workspaces.

Sender pools are the delivery backbone behind every campaign you run on Leadterra. Each workspace gets its own private pool of sending identities and a fixed daily send quota — completely isolated from other workspaces on the platform. Rather than exposing raw SMTP infrastructure, the pool abstraction lets you inspect capacity, monitor remaining volume, and trust that your sending reputation stays separate from everyone else's.

## Sender accounts

Sender accounts are the individual email identities that live inside your pool. Each account has a display name, an email address, and a status that tells you whether it is actively rotating into campaigns. When Leadterra routes an outbound message it automatically selects a healthy sender account from your pool, so you never have to assign senders per campaign manually.

Use `GET /v1/sender-accounts` to list every identity in your workspace pool:

```bash theme={null}
curl https://app.leadterra.co/v1/sender-accounts \
  -H "Authorization: Bearer sk_live_YOUR_KEY"
```

**Sample response**

```json theme={null}
{
  "data": [
    {
      "id": "sa_01hx3kqp7mbn2vd9czf6yw4e8r",
      "email": "james.walker@mail.acmecorp.io",
      "name": "James Walker",
      "status": "active"
    },
    {
      "id": "sa_01hx3kqp9ncp4we0dzg7zx5f9s",
      "email": "sarah.chen@mail.acmecorp.io",
      "name": "Sarah Chen",
      "status": "active"
    },
    {
      "id": "sa_01hx3kqpbqdq5xf1eah8ay6g0t",
      "email": "mark.osei@mail.acmecorp.io",
      "name": "Mark Osei",
      "status": "warming"
    }
  ]
}
```

A sender account in `warming` status is being gradually ramped up and will rotate into active sending once it reaches sufficient reputation. Accounts with `active` status are available for immediate use.

## Pool capacity

Your pool has a daily sending capacity that resets every 24 hours. The `dailyCapacity` field reflects the total messages your pool can send per day, and `remainingVolume` shows how many sends are still available in the current window.

Use `GET /v1/sender-pools` to inspect your pool's current capacity:

```bash theme={null}
curl https://app.leadterra.co/v1/sender-pools \
  -H "Authorization: Bearer sk_live_YOUR_KEY"
```

**Sample response**

```json theme={null}
{
  "data": {
    "id": "sp_01hx3kqpcrtd6yg2fbj9bz7h1u",
    "workspaceId": "ws_01hx3kqpdste7zh3gcka0c8i2v",
    "dailyCapacity": 2000,
    "remainingVolume": 1347,
    "resetAt": "2025-01-15T00:00:00Z",
    "senderAccountCount": 3,
    "activeSenderAccountCount": 2
  }
}
```

The `resetAt` timestamp is always midnight UTC. If your pool has multiple sender accounts, the daily capacity represents the aggregate limit across all active senders.

## How campaigns use pools

When you start a campaign, Leadterra automatically routes every outbound message through your workspace's sender pool. You do not configure individual senders at the campaign level — the platform handles rotation and load balancing across your active sender accounts to optimize deliverability. If a sender account is paused or warming, Leadterra skips it and routes through the remaining healthy accounts without interrupting your campaign.

<Tip>
  Check `remainingVolume` before launching a large campaign. If the number of leads you plan to enroll exceeds your remaining daily volume, the overflow messages will queue and send on the next reset cycle, which can delay your sequence timing.
</Tip>