Skip to main content
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: 
curl https://app.leadterra.co/v1/sender-accounts \
  -H "Authorization: Bearer sk_live_YOUR_KEY"
Sample response 
{
  "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: 
curl https://app.leadterra.co/v1/sender-pools \
  -H "Authorization: Bearer sk_live_YOUR_KEY"
Sample response 
{
  "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.
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.