Add a sender address

POST/api/v1/email/senders

POST /email/senders

curl -X POST 'https://www.unitpost.com/api/v1/email/senders' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'User-Agent: my-app/1.0' \
  -H 'Content-Type: application/json' \
  -d '{
    "address": "hello@yourdomain.com",
    "display_name": "Acme"
  }'

Response · 201

{
  "object": "sender",
  "id": "id_123",
  "domain_id": "domain_123",
  "address": "string",
  "display_name": "string",
  "from": "you@yourdomain.com",
  "source": "manual",
  "created_at": "2026-01-01T00:00:00.000Z",
  "updated_at": "2026-01-01T00:00:00.000Z"
}

Save a From address on one of your domains, as the domain page's "Add address" does. The domain may still be verifying. A mailbox already saved on that domain is a 409, so a retry never saves it twice. Requires the domains:write capability.

Request body2 fields

Field	Type	Description
`address`required	string	The mailbox to save, on one of your domains (e.g. `hello@mail.acme.com`). Its domain may still be verifying.
`display_name`	string \| null	Shown as the sender's name (`Acme Support <hello@…>`).

Response · 201 fields9 fields

Field	Type	Description
`object`required	string	—
`id`required	string	—
`domain_id`required	string	—
`address`required	string	`local_part@domain`.
`display_name`required	string \| null	—
`from`required	string	The From value to send with: `Display Name <address>`, or the address alone.
`source`required	enummanual \| api	`manual` (saved by someone) or `api` (seen on a send through the API).
`created_at`required	string	—
`updated_at`required	string	—

201400401403404409422

Add a sender address

Add a sender address

Search docs and guides