---
title: "Create a mailbox domain"
method: POST
path: "/mailbox_domains"
tags: ["Mailbox domains"]
---

# Create a mailbox domain

`POST /mailbox_domains`

## Request

- Base URL: `https://api.sandbox.monite.com/v1`
- URL: `https://api.sandbox.monite.com/v1/mailbox_domains`
- Auth: HTTP bearer

Create domain for the partner_id

## Headers

- `x-monite-version` string, required

## Request body

- object
  - `domain` string, hostname, required: The domain name, such as `mail.mycompany.com`. Can contain only alphanumeric characters (A..Z a..z 0..9), dots (.), and hyphens (-). Each segment of the domain name must start and end with either a letter or a digit.

## Response `200`

Successful Response

- DomainResponse
  - `id` string, uuid, required: Entry UUID
  - `dedicated_ip` string: A dedicated IP address assigned to this mailbox and used to send outgoing email.
  - `dns_records` union, required
    - DnsRecords
      - `receiving_dns_records` DnsRecord[], required: Set of DNS settings required by Mailgun for domain verification before emails receiving is possible.
        - `is_active` boolean, required
        - `name` string
        - `record_purpose` 'DKIM' | 'SPF'
        - `record_type` 'TXT' | 'MX' | 'CNAME', required
        - `valid` string, required: Field reflecting validation status by Mailgun.
        - `value` string, required
      - `sending_dns_records` DnsRecord[], required: Set of DNS settings required by Mailgun for domain verification before emails sending is possible.
        - `is_active` boolean, required
        - `name` string
        - `record_purpose` 'DKIM' | 'SPF'
        - `record_type` 'TXT' | 'MX' | 'CNAME', required
        - `valid` string, required: Field reflecting validation status by Mailgun.
        - `value` string, required
    - object
  - `domain` string, hostname, required: The domain name.
  - `last_updated_at` string, date-time: The time the domain was updated for the last time
  - `status` string, required

## Other responses

- `422`: Validation Error
- `500`: Internal Server Error

---

[API](https://skmtc.dev/monite/apis/monite-3.md) - [All operations](https://skmtc.dev/monite/apis/monite-3/llms.txt) - [OpenAPI document](https://skmtc.dev/monite/apis/monite-3/revisions/c13be6f83ce9?raw)