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

successboolean

Success flag

timestampstring

Response timestamp

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.