---
title: "Register Sender Domain"
method: POST
path: "/v1/sender-domains"
tags: ["sender-domains"]
---

# Register Sender Domain

`POST /v1/sender-domains`

## Request

- Base URL: `https://api.elaan.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.elaan.io/v1/sender-domains`
- Auth: none declared

## Headers

- `authorization` string, nullable

## Request body

- RegisterSenderDomainRequest
  - `domain` string, required
  - `from_local_part` string
  - `from_name` string, nullable

## Response `201`

Successful Response

- SenderDomainResponse
  - `domain` string, required
  - `status` 'pending' | 'verified' | 'failed', required: Where a sender domain is in the SES verification lifecycle. `PENDING` until the tenant adds the DKIM records and SES confirms them; `VERIFIED` once SES will sign+send for the domain; `FAILED` if SES gave up (records never appeared).
  - `from_address` string, required
  - `from_name` string, nullable, required
  - `mail_from_domain` string, nullable, required
  - `dns_records` DnsRecord[], required
    - `type` string, required
    - `name` string, required
    - `value` string, required
    - `priority` integer, nullable
  - `created_at` string, date-time, required
  - `verified_at` string, date-time, nullable, required

## Other responses

- `409`: This domain is already registered
- `422`: Validation Error

---

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