Skip to main content
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

​
Authorizations
string | header
required
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
string
required
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]"
​
name
string
Display name for the sender (max 200 characters). Shown as the “from” name in recipients’ email clients.Maximum length: 200Example: "Example Team"
​
replyTo
string
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 successfully
​
success
boolean
Indicates if the request was successfulExample: true
​
data
object
​
message
string
Confirmation messageExample: "Authenticated sender added successfully"

​
Error Responses

​
400 - Domain not verified
object
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"
}
​
409 - Duplicate sender
object
Returned when a sender with the same email already exists on the project.
{
  "success": false,
  "error": "An authenticated sender with this email already exists"
}