curl --request POST \
--url https://cloudapi.mailercloud.com/v1/senders \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"sender_email": "news@example.com",
"sender_name": "Example News"
}
'{
"id": "ZZaSxx",
"sender_email": "news@example.com",
"sender_name": "Example News",
"status": "verified"
}Add a Sender
Add a sender (from address) on a verified domain — the same as Add sender in Account Settings → Senders. A sender on a verified domain is verified at once (no confirmation email).
The address fields are optional; any you leave out are taken from your account profile. They are shown on the sender’s details only and are not used for sending.
curl --request POST \
--url https://cloudapi.mailercloud.com/v1/senders \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"sender_email": "news@example.com",
"sender_name": "Example News"
}
'{
"id": "ZZaSxx",
"sender_email": "news@example.com",
"sender_name": "Example News",
"status": "verified"
}Authorizations
Your Mailercloud API key (plain text, no Bearer prefix). Create keys in Settings → API.
Body
The from address. Its domain must be added and verified in your account.
Minimum: 5 Maximum: 100
The from name.
Maximum: 100
Plain text (ASCII); <, >, @, " and line breaks are not allowed.
Company address.
Minimum: 3 Maximum: 500
City.
Minimum: 3 Maximum: 100
State.
Minimum: 3 Maximum: 100
ZIP / postal code.
Minimum: 4 Maximum: 15
Country name or ISO code, e.g. India, IN or IND.