Skip to main content
POST
/
domains
Create Domain
curl --request POST \
  --url https://app.lettr.com/api/domains \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "domain": "example.com"
}
'
{
  "message": "Domain created successfully.",
  "data": {
    "domain": "example.com",
    "status": "approved",
    "status_label": "Approved",
    "dkim": {
      "public": "MIGfMA0GCSqGSIb3DQEBA...",
      "selector": "scph0123",
      "headers": "from:to:subject:date",
      "signing_domain": "example.com"
    }
  }
}
Adds a new sending domain to your team. After creating, you’ll need to add the required DNS records and verify the domain before you can send from it.

Authorizations

​
Authorization
string
header
required

API key for authentication

Body

application/json

Request to create a new sending domain

​
domain
string
required

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

Maximum string length: 255
Pattern: ^([a-zA-Z0-9]([a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?\.)+[a-zA-Z]{2,}$
Example:

"example.com"

Response

Domain created successfully

Response after successfully creating a domain

​
message
string
required

Human-readable success message

Example:

"Domain created successfully."

​
data
object
required

View of a sending domain