List your custom domains | freecustom-email

Returns all custom domains you have added to your account, along with their verification status and the DNS records needed to verify them.

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

Custom domains are shared between the API and the webapp dashboard — a domain added here appears in the dashboard immediately and vice-versa.

Returns all custom domains you have added to your account, along with their verification status and the DNS records needed to verify them. **Plan required:** Growth ($49/mo) or Enterprise ($149/mo). Custom domains are **shared** between the API and the webapp dashboard — a domain added here appears in the dashboard immediately and vice-versa.

Authentication

AuthorizationBearer

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

Response

datalist of objects

countinteger

successboolean

Errors

401

Unauthorized Error

403

Forbidden Error

429

Too Many Requests Error

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

1	{
2	"data": [
3	{
4	"domain": "mail.acme.com",
5	"added_at": "2026-01-15T10:00:00.000Z",
6	"verified": true,
7	"mx_record": "mx.freecustom.email",
8	"txt_record": "freecustomemail-verification=a1b2c3d4e5f6..."
9	},
10	{
11	"domain": "staging.acme.com",
12	"added_at": "2026-03-10T08:30:00.000Z",
13	"verified": false,
14	"mx_record": "mx.freecustom.email",
15	"txt_record": "freecustomemail-verification=9z8y7x6w5v4u..."
16	}
17	],
18	"count": 2,
19	"success": true
20	}