Domains
Add domains
Adds one or more domains for the authenticated client.
Domain Validation
- Domain format is validated according to RFC standards (e.g., example.com)
- Domain names are normalized (http/https and trailing slashes removed)
- Duplicate domains in the request are rejected
Redirect URL Validation
- Redirect URLs are validated according to RFC standards (same validation as domain names)
- Protocol (http://, https://) and trailing slashes are automatically removed
- Redirect URLs are normalized to lowercase
- Each redirect URL must be a valid domain format (e.g., mysite.com, example.co.in)
Slot Management
- Client must have sufficient domain slots available
- Domain slots are automatically updated after successful addition
Existing Domains
- Active domains: Cannot be added (returns error)
- Inactive domains: Reactivated and ownership transferred to the client
Default Settings
- All new domains have warmup enabled by default
- Initial status is set to pending
post/api/v1/domains
Request
- Base URL: https://api.aerosend.io
- URL: https://api.aerosend.io/api/v1/domains
- Auth: API key in header X-API-Key
Request body
Example request
{
"domains": [
{
"domain": "example.com",
"redirect_url": "mysite.com"
}
]
}Response
Domains added successfully
Example response
{
"success": true,
"data": {
"added_count": 3,
"reactivated_count": 1,
"domains": [
{
"id": 123,
"domain": "example.com",
"status": "pending"
}
]
},
"timestamp": "2025-12-14T10:30:00Z"
}Changes
No recorded changes to this operation across all 1 revision of this API.