Domains

Create Domain

Register a new sending domain with your account. The domain will be created with SparkPost and stored as approved by default, unless global domain reputation marks it for review or blacklist. Adding a domain your team already has returns 409 and leaves its DNS records and verification status unchanged.

post/domains

Request

  • Base URL: https://app.lettr.com/api
  • URL: https://app.lettr.com/api/domains
  • Auth: HTTP bearer

Request body

domainstring required

The domain name to register (e.g., example.com)

Example request

{
  "domain": "example.com"
}

Response

Domain created successfully

messagestring required

Human-readable success message

Example response

{
  "message": "Domain created successfully.",
  "data": {
    "domain": "example.com",
    "status": "pending",
    "status_label": "Pending Review"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.