Skip to main content
GET
/
api
/
senders
/
{id}
Get Sender Details
curl --request GET \
  --url https://app.puffle.ai/api/senders/{id} \
  --header 'Authorization: Bearer <token>'
{
  "account": {
    "id": "aaaa1111-1111-1111-1111-111111111111",
    "user_id": "u1111111-1111-1111-1111-111111111111",
    "type": "email",
    "display_name": "Sarah at Acme",
    "status": "active",
    "created_at": "2026-04-20T10:00:00Z",
    "updated_at": "2026-04-21T09:00:00Z",
    "provider_account_id": null,
    "profile_url": null,
    "is_premium": null,
    "has_sales_navigator": null,
    "weekly_connection_limit": null,
    "weekly_message_limit": null,
    "email_address": "sarah@acme.com",
    "domain_id": "dddd1111-1111-1111-1111-111111111111",
    "agentmail_inbox_id": "inbox_abc123",
    "instantly_account_id": null,
    "warmup_status": "active",
    "first_name": "Sarah",
    "last_name": "Chen",
    "signature": "Best,\nSarah",
    "daily_limit": 50,
    "instantly_tag_id": null,
    "instantly_warmup_tag_id": null,
    "stats": {
      "today_sent": 8,
      "today_committed": 12
    }
  },
  "campaigns": [
    {
      "id": "cccc1111-1111-1111-1111-111111111111",
      "name": "Founder outbound",
      "status": "active",
      "daily_limit": 100,
      "type": "email",
      "stats": null,
      "operating_hours": null,
      "sequence_nodes": []
    }
  ],
  "mappings": [
    {
      "campaign_id": "cccc1111-1111-1111-1111-111111111111",
      "account_id": "aaaa1111-1111-1111-1111-111111111111"
    }
  ],
  "campaignStatsByStatus": {
    "cccc1111-1111-1111-1111-111111111111": {
      "contacted": 20
    }
  },
  "campaignSenderStatsByStatus": {
    "cccc1111-1111-1111-1111-111111111111:aaaa1111-1111-1111-1111-111111111111": {
      "contacted": 20
    }
  },
  "campaignSenderTodayStatsByStatus": {},
  "campaignActiveProspectsCount": {
    "cccc1111-1111-1111-1111-111111111111": 20
  }
}
CLI: 
puffle sender detail --id <id>

​
Overview

Return one sender’s operational detail: the account row, today’s usage, projected commitments, mapped campaigns, and sender-scoped campaign prospect status breakdowns. Use List Senders first to get the sender ID.

​
AI agent notes

Call List Senders first unless you already have the sender account ID. Campaign-capable readiness is channel-specific: LinkedIn senders need connected; email senders need active for non-admin campaign traffic. Campaign arrays can be empty when the sender is connected but not assigned anywhere. Use Get Sender Schedule when you need the future commitment map for this sender.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
string<uuid>
required

Account UUID.

Response

Sender details and usage. Campaign arrays are empty when the sender is not attached to any campaigns.

​
account
object
required
​
campaigns
object[]
required
​
mappings
object[]
required
​
campaignStatsByStatus
object
required
​
campaignSenderStatsByStatus
object
required
​
campaignSenderTodayStatsByStatus
object
required
​
campaignActiveProspectsCount
object
required