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

Check a mailbox

Signs in to the mailbox again and reads its domain's SPF, DKIM and DMARC again. A refused sign-in disconnects it until it is connected again. Owners and admins only.

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

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 check
MCP tooltroopy_check_mailbox
Rate limit20 calls in 60 seconds, for each key

Path parameters

id*string

A 24-character id

Response

200 · 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.
429 rate_limitedWait the number of seconds in Retry-After, then retry.