2026-07-24

We've exposed a newsletter's custom domain verification on the public API, so you can check DNS setup programmatically instead of only in the web app.

Two new read-only endpoints return the underlying DNS records and their current verification state:

• GET /v1/newsletters/{id}/sending-domain — the records for your custom sending domain, along with any warnings and detected DNS provider.
• GET /v1/newsletters/{id}/hosting-domain — the records for your custom hosting (archive) domain.

The newsletter object also now includes two read-only summary fields:

• sending_domain_status
• hosting_domain_status

Each is an at-a-glance verification status (for example none, invalid, or valid) so you can tell whether a newsletter's domains are configured correctly without fetching the full record set.

These additions are read-only and don't change the behavior of any existing endpoints.

Retrieve a newsletter's sending domain records and verification state:

import requests

url = "https://api.buttondown.com/v1/newsletters/{id}/sending-domain"
headers = {
  "Authorization": "Token $BUTTONDOWN_API_KEY"
}

response = requests.request("GET", url, headers=headers)
print(response.text)

The summary status is also available inline on the newsletter object:

import requests

url = "https://api.buttondown.com/v1/newsletters/{id}"
headers = {
  "Authorization": "Token $BUTTONDOWN_API_KEY"
}

response = requests.request("GET", url, headers=headers)
print(response.text)