Sign in
Reach: Profiles

Get connected sending domain

Get the sending domain connected to the profile, its verification status and any suspended sender addresses.

Campaigns only go out once a domain is connected and active, so this is the cheapest way to check that precondition before building one. A profile with no domain connected returns the same shape with every field set to null. For the individual MX, SPF, DKIM and DMARC records behind the status, use the DNS status endpoint.

get/api/reach/v1/profiles/{profileUuid}/domains

Path parameters

profileUuidstring required
Example:550e8400-e09b-41d4-a716-400055000000

Profile uuid parameter

Response

Success response

domainstring nullable

Domain campaigns are sent from. It may be a subdomain of the domain that was connected, so it will not always match the website domain.

status'active' | 'inactive' | 'pending' | 'blocked' nullable

Campaigns can only be sent while the domain is active.

created_atstring date-time nullable

When the domain was connected to the profile.

updated_atstring date-time nullable

When the domain or its verification state last changed.

Example response

{
  "domain": "mail.example.com",
  "status": "active",
  "created_at": "2025-01-01T00:00:00Z",
  "updated_at": "2025-01-15T10:30:00Z",
  "suspended_sender_emails": [
    {
      "email": "newsletter@example.com",
      "email_local_part": "newsletter",
      "suspended_at": "2025-01-15T10:30:00Z"
    }
  ]
}

Changes

Changed in 1 of the 88 revisions of this API.1