Skip to content

Verify Survey Domain

POST
/feedback/sending-domains/verify

Start verification of a domain for SURVEY sending, and get the DNS records back.

The records include DMARC, which Gmail and Yahoo require of bulk senders - publishing SPF and DKIM alone passes this check and still lands in spam.

Idempotent: re-running it on a domain already being verified re-reads the records rather than starting again, and a previously FAILED domain is reset to pending so the reconciler picks it up.

A domain bought through graph8 has its DNS added automatically; a domain you own needs the records added at your own provider before /status will ever turn green.

Authorizations

Parameters

Header Parameters

X-Target-Org-Id
Any of:
string

Request Body required

Start verification of a survey sending domain.

object
domain
required

The sending domain or subdomain, e.g. feedback.acme.com.

string
>= 1 characters

Responses

200

Successful Response

object
data
required

An open envelope for a verification result.

Open because the DNS record set grows: DMARC was added to it after SPF and DKIM, and closing the shape would have silently dropped the record that decides whether Gmail accepts the mail at all.

object
key
additional properties
any
pagination
Any of:
object
has_next
required

Whether there are more pages

boolean
limit
required

Items per page

integer
next_cursor
Any of:
string
notes
Any of:
Array<string>
page
required

Current page number (1-indexed)

integer
total
required

Total number of items

integer
total_available
Any of:
integer
total_is_lower_bound
Any of:
boolean

422

Validation Error

object
detail
Array<object>
object
loc
required
Array
msg
required
string
type
required
string