---
title: "Add a sender domain"
method: POST
path: "/domains"
tags: ["Domains"]
---

# Add a sender domain

`POST /domains`

Adds a new sender domain and creates the corresponding SendGrid whitelabel domain.
Requires an active subscription and SendGrid subuser.

## Request body

- object
  - `domain` string, required — Domain name (e.g., example.com). Do not include @ or protocol.

## Response `201`

Domain created successfully

- WhitelabelDomain
  - `id` integer
  - `domain` string, required
  - `sendgrid_whitelabel_domain_id` integer, nullable
  - `validated_at` string, date-time, nullable
  - `dns` object — DNS records from SendGrid (included on show)
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Other responses

- `403` — Forbidden (not subscribed or no SendGrid subuser)
- `422` — Validation error (invalid domain, already taken, or already exists)

---

[API](https://skmtc.net/sendfox/apis/sendfox-api.md) · [All operations](https://skmtc.net/sendfox/apis/sendfox-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sendfox/sendfox-api/revisions/c5728da3037f/schema)