Delete a domain

Remove a sending domain. It can no longer be sent from.

DELETE /v1/domains/{id}

Requires a Full access API key.

Path parameters

Parameter	Type	Required	Description
id	string	Yes	The domain id.

Example

curl

curl -X DELETE "https://api.sendgrail.com/v1/domains/$DOMAIN_ID" \
  -H "Authorization: Bearer $SENDGRAIL_API_KEY"

Node.js

await fetch(`https://api.sendgrail.com/v1/domains/${id}`, {
  method: 'DELETE',
  headers: { Authorization: `Bearer ${process.env.SENDGRAIL_API_KEY}` },
});

Response

{
  "object": "domain",
  "id": "5f1c3a9e-0d42-4b7c-9a63-2e8b41d7c015",
  "deleted": true
}

What deleting does

Deleting removes the sending identity: the domain can no longer be sent from, and the identity is torn down at the mail provider so it isn't left orphaned. The DNS records you added at your registrar are yours — deleting the domain here doesn't touch them, so remove them yourself if you no longer want them.

Re-adding the domain later gives it a new DKIM key and a fresh set of records to publish; the old ones won't verify it. If you only want to stop tracking or change TLS, update the domain instead of deleting it.

Errors

A domain belonging to another team answers 404. A Sending access key answers 403. See Errors.