Skip to main content
TroopyDocs
GuidesSet up and use TroopyAppsConnect your servicesAPIThe API, the CLI and MCPChangelogEach update to Troopy

Developers

Account

Troop

Skills

Tasks and projects

Needs you

Routines and triggers

Brain

Docs

Canvas

Email

CRM

Outreach

Customers

Analytics

Sessions

Surveys

Support Agent

Tests and incidents

Disputes

Apps

Vault

Computer

Open Troopy
Troopy

API reference / Email

Verify the email domain

Checks the DNS records of the workspace's email domain now. Troopy also checks a domain that waits every 5 minutes, for 3 days. Owners and admins only.

post/api/v1/email/domain/verify

Authorization

HeaderAuthorization: Bearer <API key>
Or the headerX-API-Key: <API key>
API keyMake one in Troopy under Settings > API keys. It acts as you, in its workspace.
Scopesagents:write

Other ways to call it

CLItroopy email-domain verify
MCP tooltroopy_verify_email_domain
Rate limit10 calls in 60 seconds, for each key

Response

200 · application/json
data*object
10 properties
domain*string

Like agents.acme.com

status*enum<string>

pending waits for its DNS records. verified: teammates send and get mail on it. failed: error says why

pendingverifiedfailed

error*string | null

Why it failed, or what still waits

records*array<object>

The records to add at the DNS host of the domain

7 properties
type*enum<string>

CNAMEMXTXT

name*string

The full name of the record

value*string
priority*integer | null

For an MX record

purpose*enum<string>

dkiminboundmail_fromdmarc

ok*boolean

What the latest check found

optional*boolean

It helps mail land, but the domain verifies without it

zone*string | null

The DNS zone that holds the records. A DNS host asks for the name of a record without it

dnsHost*string | null

Who serves the zone, like Namecheap, when Troopy knows its name servers

zoneMail*array<object>

The MX records of the zone when the domain is a subdomain: the business's own mail. Keep them

2 properties
priority*integer
host*string
checkedAt*string | null
verifiedAt*string | null
createdAt*string

ISO 8601 date and time

Errors

401 unauthorizedSend an API key as `Authorization: Bearer tr_live_...`. Create one in Troopy under Settings.
403 forbiddenThe key lacks a scope this operation needs, or its owner lacks the role. detail says which; create a key with the scope, or ask an organization owner or admin.
429 rate_limitedWait the number of seconds in Retry-After, then retry.