Skip to main content
GET
/
api
/
email
/
accounts
List email sender accounts
curl --request GET \
  --url https://app.puffle.ai/api/email/accounts \
  --header 'Authorization: Bearer <token>'
{ "accounts": [ { "id": "aaaa1111-1111-1111-1111-111111111111", "user_id": "11111111-1111-1111-1111-111111111111", "type": "email", "domain_id": "dddd1111-1111-1111-1111-111111111111", "email_address": "[email protected]", "agentmail_inbox_id": "inbox_abc123", "instantly_account_id": "[email protected]", "status": "active", "warmup_status": "completed", "display_name": "Sarah Smith", "first_name": "Sarah", "last_name": "Smith", "signature": "Best,\n%first_name%", "instantly_tag_id": "tag_user123", "instantly_warmup_tag_id": "tag_warmup", "created_at": "2026-04-01T08:00:00Z", "updated_at": "2026-04-18T12:00:00Z", "email_domains": { "id": "dddd1111-1111-1111-1111-111111111111", "domain": "acme.com", "status": "verified" } } ] }

Overview

Return every email sender account owned by the caller, newest first. Each row is joined with its backing email_domains entry so clients can render domain status (verified, pending, …) without a second round-trip. Warmup analytics (stat_warmup_score, health_score, daily sends) are NOT included here — fetch them separately via GET /api/email/accounts/warmup-analytics.
This operation shares the URL path /api/email/accounts with other verbs. See the sibling page for related operations on the same resource.

Authorizations

Authorization
string
header
required

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

Response

Array of email accounts. Empty array is a valid response for users who have not created any inboxes.

accounts
object[]
required