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

Send a test from a mailbox

Sends a test from the mailbox to a teammate's own inbox (Outreach's, else the lead's, unless you name one). When it arrives, what the receiving side said of it (SPF, DKIM, DMARC, spam) shows in the mailbox's test: read it again in a minute. Needs the teammates' inboxes set up. Owners and admins only.

post/api/v1/mailboxes/{id}/test

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.
Scopesoutreach:write

Other ways to call it

CLItroopy mailboxes test
MCP tooltroopy_test_mailbox
Rate limit10 calls in 60 seconds, for each key
RetriesSend an Idempotency-Key header. A retry with the same key gets the first answer back, and the operation runs one time.

Path parameters

id*string

A 24-character id

Body

application/json
teammatestring

Whose inbox it goes to

At most 40 characters

Response

202 · application/json
data*object
15 properties
id*string

A 24-character id

address*string
name*string

The From name people see

signature*string
provider*enum<string>

googlemicrosoftzohozoho_euzoho_infastmail

providerName*string
status*enum<string>

activepauseddisconnected

why*string | null

Why it isn't active

dailyCap*integer

The most it sends a day, once ramped up

gapMinutes*integer

Minutes between its sends, at least

readAll*boolean

Read all: Troopy keeps every new mail of its inbox for 30 days, and everyone in the workspace reads it. For a shared address.

dns*object | null

Its domain's SPF, DKIM and DMARC as last checked: a campaign needs SPF or DKIM

4 properties
spf*enum<string>

pass: one SPF record naming its provider; other: one that doesn't name it directly; many: more than one

passothermissingmany

dkim*enum<string>

found at its provider's usual selector; unknown: not there

foundunknown

dmarc*object | null
1 properties
policy*string
checkedAt*string

ISO 8601 date and time

test*object | null

Its last test send

4 properties
to*string

The teammate's inbox it went to

sentAt*string

ISO 8601 date and time

receivedAt*string | null
verdicts*object | null

What the receiving side said: pass, fail or gray each

4 properties
spf*string | null
dkim*string | null
dmarc*string | null
spam*string | null
createdBy*object

Who wrote it

3 properties
type*enum<string>

personagentapi

id*string
name*string
createdAt*string

ISO 8601 date and time

Errors

400 invalid_inputFix the field named in detail. Each operation's schema is in /api/v1/openapi.json.
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.
404 not_foundCheck the path and any id in it. Every operation is listed in /api/v1/openapi.json.
409 conflictThis Idempotency-Key was used for a different request, or that request is still running. Use a new key for a new request.
429 rate_limitedWait the number of seconds in Retry-After, then retry.