Create a domain

Registers a new inbound-email domain. The response includes the DNS records customers must add at their DNS provider before the domain can receive mail.

Authorization

Authorization<token>

API key authentication. Allowed headers-- "Authorization: ApiKey <novu_secret_key>".

In: header

Request Body

application/jsonRequired

nameRequiredstring

The domain name (e.g. "recent.dev")

dataobject

Optional string key-value metadata (max 10 keys, 500 characters total for keys+values).

Header Parameters

idempotency-keystring

A header for idempotency purposes

Response Body

Created

_idRequiredstring

nameRequiredstring

statusRequiredstring

Value in: "pending" | "verified"

mxRecordConfiguredRequiredboolean

dnsProviderstring

_environmentIdRequiredstring

_organizationIdRequiredstring

createdAtRequiredstring

updatedAtRequiredstring

expectedDnsRecordsarray<object>

dataobject

String key-value metadata (max 10 keys, 500 characters total when set via API).

export interface Response {
  _id: string;
  name: string;
  status: "pending" | "verified";
  mxRecordConfigured: boolean;
  dnsProvider?: string;
  _environmentId: string;
  _organizationId: string;
  createdAt: string;
  updatedAt: string;
  expectedDnsRecords?: ExpectedDnsRecordDto[];
  /**
   * String key-value metadata (max 10 keys, 500 characters total when set via API).
   */
  data?: {
    [k: string]: string;
  };
}
export interface ExpectedDnsRecordDto {
  type: string;
  name: string;
  content: string;
  ttl: string;
  priority?: number;
}

curl -X POST "https://api.novu.co/v1/domains" \
  -H "idempotency-key: string" \
  -H "Authorization: <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "data": {
      "property1": "string",
      "property2": "string"
    }
  }'

{
  "_id": "string",
  "name": "string",
  "status": "pending",
  "mxRecordConfigured": true,
  "dnsProvider": "string",
  "_environmentId": "string",
  "_organizationId": "string",
  "createdAt": "string",
  "updatedAt": "string",
  "expectedDnsRecords": [
    {
      "type": "MX",
      "name": "inbound",
      "content": "inbound-smtp.us-east-1.amazonaws.com",
      "ttl": "Auto",
      "priority": 10
    }
  ],
  "data": {
    "property1": "string",
    "property2": "string"
  }
}

Authorization

Request Body

Header Parameters

Response Body

On this page