---
title: "Add sending domain"
method: POST
path: "/websites"
tags: ["Websites"]
---

# Add sending domain

`POST /websites`

Adds a sending domain to the authenticated company and returns the SPF, DKIM, MAIL FROM, and inbound DNS records required for setup.

## Request body

- object
  - `domain` string, required — Domain to add.

## Response `200`

Website added

- object
  - `success` boolean
  - `website` Website
    - `id` string
    - `domain` string
    - `status` 'not_started' | 'pending' | 'verified' | 'failed' | 'misconfigured'
    - `message` string — Creation or setup summary when returned by a mutating operation.
    - `dnsRecords` object, nullable
    - `dkim` object — Normalized DKIM type, status, and diagnostics.
    - `spf` object — Normalized SPF status, expected record, and diagnostics.
    - `mailFrom` object — Normalized custom MAIL FROM MX status and diagnostics.
    - `lastVerifiedAt` string, date-time, nullable
    - `nextVerificationAt` string, date-time, nullable
    - `createdAt` string, date-time

## Other responses

- `400` — Validation or provisioning error
- `401` — Unauthorized
- `403` — Provisioning forbidden
- `404` — Provisioning resource not found
- `409` — Domain conflict
- `500` — Website could not be added

## Changes

- **2026-08-02** `36f92fc0caa2` — 5 breaking
  - the response property `success` became optional for the status `400`
  - the response property `success` became optional for the status `401`
  - the response property `success` became optional for the status `403`
  - the response property `success` became optional for the status `404`
  - …1 more
- **2026-07-14** `83e7fd773745` — 8 info
  - added the optional property `website/createdAt` to the response with the `200` status
  - added the optional property `website/dkim` to the response with the `200` status
  - added the optional property `website/dnsRecords` to the response with the `200` status
  - added the optional property `website/id` to the response with the `200` status
  - …4 more
- **2026-07-08** `98ccd00e35a4` — 5 warning
  - added the new `failed` enum value to the `website/status` response property for the response status `200`
  - added the new `misconfigured` enum value to the `website/status` response property for the response status `200`
  - added the new `not_started` enum value to the `website/status` response property for the response status `200`
  - added the new `pending` enum value to the `website/status` response property for the response status `200`
  - …1 more
- …earlier changes not shown

[Full history](https://skmtc.dev/sequenzy/apis/sequenzy-api/changes/websites/post.md)

---

[API](https://skmtc.dev/sequenzy/apis/sequenzy-api.md) · [All operations](https://skmtc.dev/sequenzy/apis/sequenzy-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sequenzy/sequenzy-api/revisions/36f92fc0caa2/schema)