Create a mailbox domain | Monite Documentation

curl -X POST https://api.sandbox.monite.com/v1/mailbox_domains \
     -H "x-monite-version: 2024-05-25" \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "domain": "domain"
}'

{
  "id": "id",
  "dns_records": {
    "receiving_dns_records": [
      {
        "is_active": true,
        "name": "name",
        "record_purpose": "DKIM",
        "record_type": "TXT",
        "valid": "valid",
        "value": "value"
      }
    ],
    "sending_dns_records": [
      {
        "is_active": true,
        "name": "name",
        "record_purpose": "DKIM",
        "record_type": "TXT",
        "valid": "valid",
        "value": "value"
      }
    ]
  },
  "domain": "domain",
  "status": "status",
  "dedicated_ip": "dedicated_ip",
  "last_updated_at": "2024-01-15T09:30:00Z"
}

Create domain for the partner_id

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Headers

x-monite-versionstringRequired

Request

This endpoint expects an object.

domainstringRequiredformat: "hostname"

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

Successful Response

idstringformat: "uuid"

Entry UUID

dns_recordsobject or map from strings to any

domainstringformat: "hostname"

The domain name.

statusstring

dedicated_ipstring

A dedicated IP address assigned to this mailbox and used to send outgoing email.

last_updated_atdatetime

The time the domain was updated for the last time

Errors

400

Post Mailbox Domains Request Bad Request Error

401

Post Mailbox Domains Request Unauthorized Error

403

Post Mailbox Domains Request Forbidden Error

409

Post Mailbox Domains Request Conflict Error

422

Post Mailbox Domains Request Unprocessable Entity Error

429

Post Mailbox Domains Request Too Many Requests Error