Delete domain
Permanently removes a custom domain from your workspace and disables all associated sending configuration. This action is irreversible. Requires domains:manage scope.
Authorization
bearerAuth Bearer token authentication. Use a Regular API key for email sending, or an Admin API key for marketing and automation endpoints.
Get your API keys from Settings → API Keys (regular) or Settings → Admin API Keys (admin) in the dashboard.
In: header
Path Parameters
Domain ID to delete.
uuidResponse Body
application/json
application/json
application/json
application/json
curl -X DELETE "https://api.keplars.com/api/v1/public/domains/delete-domain/497f6eca-6276-4993-bfeb-53cbbbba6f08"{
"success": true,
"message": "Success"
}{
"success": false,
"error": "VALIDATION_ERROR",
"message": "Field 'to' is required"
}{
"success": false,
"error": "VALIDATION_ERROR",
"message": "Field 'to' is required"
}{
"success": false,
"error": "VALIDATION_ERROR",
"message": "Field 'to' is required"
}Create a domain API key POST
Generates a Regular API key (`kms_xxx.live_xxx`) tied to a verified custom domain. Use this key to authenticate calls to `/send-email/*`. **The full key is shown once and cannot be retrieved again — store it securely.** Requires `api-keys:create` scope.
Get domain status GET
Returns the current verification state of a domain. Poll this after `POST /api/v1/public/domains/add-domain` until `verification_status` is `verified`. Requires `domains:manage` scope.