API Reference
Contacts
Custom Fields
Campaigns
Contact Lists
Senders
Create Sender
Create a new sender identity with email address and display name using the AutoSend API.
POST
/
senders
curl --request POST \
--url https://api.autosend.com/v1/senders \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"email": "[email protected]",
"name": "Example Team",
"replyTo": "[email protected]"
}'
{
"success": true,
"data": {
"sender": {
"id": "60d5ec49f1b2c72d9c8b4567",
"email": "[email protected]",
"name": "Example Team",
"replyTo": "[email protected]"
},
"projectId": "60d5ec49f1b2c72d9c8b1234"
},
"message": "Authenticated sender added successfully"
}
curl --request POST \
--url https://api.autosend.com/v1/senders \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"email": "[email protected]",
"name": "Example Team",
"replyTo": "[email protected]"
}'
{
"success": true,
"data": {
"sender": {
"id": "60d5ec49f1b2c72d9c8b4567",
"email": "[email protected]",
"name": "Example Team",
"replyTo": "[email protected]"
},
"projectId": "60d5ec49f1b2c72d9c8b1234"
},
"message": "Authenticated sender added successfully"
}
Authorizations
Bearer authentication header of the form Bearer
<token>, where <token> is your auth token.Body
Sender data for creating a new authenticated sender. The email domain must match a verified domain on the project.Email address for the sender. The domain portion must match a verified domain on the project.Must be a valid email address.Example:
"[email protected]"Display name for the sender (max 200 characters). Shown as the “from” name in recipients’ email clients.Maximum length:
200Example: "Example Team"Reply-to email address. When recipients reply to emails from this sender, replies go to this address.Must be a valid email address.Example:
"[email protected]"Response
Sender created successfullyIndicates if the request was successfulExample:
trueShow child attributes
Show child attributes
The created sender object
Show child attributes
Show child attributes
Unique sender identifierExample:
"60d5ec49f1b2c72d9c8b4567"Sender email addressExample:
"[email protected]"Display name for the senderExample:
"Example Team"Reply-to email addressExample:
"[email protected]"ID of the project the sender belongs toExample:
"60d5ec49f1b2c72d9c8b1234"Confirmation messageExample:
"Authenticated sender added successfully"Error Responses
Returned when the sender’s email domain does not match any verified domain on the project.
{
"success": false,
"error": "A verified domain is required before adding an authenticated sender"
}
Returned when a sender with the same email already exists on the project.
{
"success": false,
"error": "An authenticated sender with this email already exists"
}
⌘I
curl --request POST \
--url https://api.autosend.com/v1/senders \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"email": "[email protected]",
"name": "Example Team",
"replyTo": "[email protected]"
}'
{
"success": true,
"data": {
"sender": {
"id": "60d5ec49f1b2c72d9c8b4567",
"email": "[email protected]",
"name": "Example Team",
"replyTo": "[email protected]"
},
"projectId": "60d5ec49f1b2c72d9c8b1234"
},
"message": "Authenticated sender added successfully"
}