BUbuttondown
Newsletters

Retrieve Hosting Domain

Changed on

Retrieve the DNS verification status for a newsletter's custom hosting domain. This synchronously re-verifies the domain's DNS records.

get/newsletters/{id}/hosting-domain

Request

  • Base URL
    https://api.buttondown.com/v1
  • URL
    https://api.buttondown.com/v1/newsletters/{id}/hosting-domain
  • Auth
    API key in header Authorization

Path parameters

idstring required

Response

OK

domainstring required

The custom hosting domain being verified.

record_typestring required

The DNS record type the domain should use (typically CNAME).

datastring[] required

The record values currently observed at the domain, if any.

nameserversstring[]

The domain's nameservers, used to detect its DNS provider.

status'none' | 'invalid' | 'valid' required

The DNS verification status of a newsletter's custom hosting domain.

Changes

  • 0b8842d5bd7fRevision changes
    • info

      added the optional property //// to the response with the status

  • 9bd7eed8b5aeRevision changes
    • info

      added the optional property // to the response with the status