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

# Add a domain

`POST /api/domains`

## Request

- Base URL: `https://arc-relay.com`
- URL: `https://arc-relay.com/api/domains`
- Auth: HTTP bearer

## Request body

- object
  - `domain` string, required

## Response `200`

Domain added: { domain, dns_records }. domain is the new row (status "pending", verification_token); dns_records lists the DNS records to publish, each with type, host, value, priority, required and purpose (MX and the verification TXT are required, SPF is recommended).

---

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