---
title: "Register a domain on SES"
method: POST
path: "/domains"
tags: ["Domains"]
---

# Register a domain on SES

`POST /domains`

## Request

- Base URL: `https://sending.dev/api/v1`
- URL: `https://sending.dev/api/v1/domains`
- Auth: HTTP bearer

SES onboarding (Easy DKIM + MAIL-FROM); returns the DNS records to publish. Required scope: `domains:write`.

## Request body

- CreateDomain
  - `name` string, required
  - `region` string

## Response `200`

Domain already exists.

- DomainCreated
  - `id` string, uuid, required
  - `status` string, required
  - `dnsRecords` DnsRecord[], required
    - `type` string, required
    - `name` string, required
    - `value` string, required

## Other responses

- `201`: Domain registered (pending).
- `401`: Missing or invalid token.
- `403`: Insufficient scope.
- `422`: Invalid input.
- `502`: Upstream provider error (e.g. SES).

---

[API](https://skmtc.dev/sending/apis/sending-dev-api.md) · [All operations](https://skmtc.dev/sending/apis/sending-dev-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sending/apis/sending-dev-api/revisions/9fe78d2918a1?raw)