Add a domain

POST

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

Domains

Last modified:2026-03-12 10:32:36

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

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 'Content-Type: application/json' \
--data-raw '{
    "domain_name": "notifications.example.com"
}'

Response Example

201 - Example 1

{
    "domain": {}
}

Modified at 2026-03-12 10:32:36

Get your domain

Delete your domain