Skip to main content

​
Domain statuses

StatusDescriptionCan send email
pending_dnsDomain added, DNS records not yet verified.No
pending_warmupDNS verified, warming up.Yes (10/day limit)
activeFully verified and warmed up.Yes (50/day limit, configurable)
suspendedSending suspended.No

​
AddDomain

Adds a custom domain to your account. Returns the domain record with a verification token. DNS records are configured asynchronously — check the required records using ListDomains or VerifyDomain after a moment. Inputs
​
domain
string
required
The domain name to add (e.g., "example.com"). Must be a valid domain format, not a public email provider domain, and not already registered on AgentPost.
Output
​
id
string
Unique identifier for the domain record.
​
domain
string
The domain name you added.
​
status
string
Initial domain status. Typically "pending_dns" immediately after adding.
​
verification_token
string
Token used to verify domain ownership via DNS.
​
message
string
A human-readable description of the next steps.
DNS records are set up asynchronously. Wait a moment after calling AddDomain, then call VerifyDomain to retrieve the required DNS records and check their status.

​
ListDomains

Lists all custom domains on your account with their verification status and sending capability. Inputs This tool takes no inputs. Output
​
domain_count
integer
Total number of domains on your account.
​
domains
array

​
VerifyDomain

Triggers a DNS verification check for a custom domain. Checks DKIM, SPF, and DMARC records against what the sending provider expects. If all checks pass and the domain is in pending_dns status, the domain transitions to pending_warmup and a warmup period begins (default 72 hours). You can call this tool multiple times to re-check DNS records. Inputs
​
domain
string
required
The domain name to verify (e.g., "example.com"). You must own this domain.
Output
​
domain
string
The domain name that was checked.
​
status
string
Updated domain status after the verification attempt.
​
verification_passed
boolean
Whether all DNS checks passed.
​
verified_at
string
ISO 8601 timestamp of when the domain passed verification. null if verification has not passed yet.
​
warmup_ends_at
string
ISO 8601 timestamp of when the warmup period ends. null if not in warmup.
​
dns_checks
object
Results of individual DNS record checks. Includes results for DKIM, SPF, and DMARC records.

​
RemoveDomain

Removes a custom domain from your account and from the sending provider. Mailboxes on the domain lose sending capability immediately.
This action is irreversible. All mailboxes on the domain will lose sending capability. If the provider removal fails, the domain record is still deleted locally.
Inputs
​
domain
string
required
The domain name to remove (e.g., "example.com"). You must own this domain.
Output
​
deleted
boolean
Always true when the domain was successfully removed.
​
domain
string
The domain name that was removed.