Add a domain

POST

https://api.hmsovereign.com/api/v1/domains

Domains

Last modified:2026-01-30 13:43:45

Maintainer:Jesper Rietbergen

Create a custom email domain in Resend for sending notifications from your organization. Requires a Resend API key configured via BYOK. You can only have one domain configured per organization.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Examples

Responses

🟢201

application/json

Domain created successfully in Resend

Body

🟠409BadRequest

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.hmsovereign.com/api/v1/domains' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "domain_name": "notifications.example.com"
}'

Response Example

201 - Example 1

{
    "domain": {}
}

Modified at 2026-01-30 13:43:45

Get your domain

Delete your domain