Remove a custom domain | freecustom-email

Permanently removes a custom domain from your account.

Side effects:

All API inboxes registered at @{domain} are automatically unregistered.
The domain is also removed from the webapp dashboard.

Plan required: Growth ( $49/mo) or Enterprise ($ 149/mo).

Permanently removes a custom domain from your account. **Side effects:** - All API inboxes registered at `@{domain}` are automatically unregistered. - The domain is also removed from the webapp dashboard. **Plan required:** Growth ($49/mo) or Enterprise ($149/mo).

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

domainstringRequired

The bare domain name to remove (e.g. mail.acme.com).

Response

messagestring

successboolean

inboxes_removedlist of strings

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

1	import requests
2
3	url = "https://api2.freecustom.email/v1/custom-domains/mail.acme.com"
4
5	headers = {"Authorization": "Bearer <token>"}
6
7	response = requests.delete(url, headers=headers)
8
9	print(response.json())

1	{
2	"message": "\"mail.acme.com\" removed.",
3	"success": true,
4	"inboxes_removed": [
5	"support@mail.acme.com",
6	"noreply@mail.acme.com"
7	]
8	}