Skip to content
GridRouterhome

Search

Search providers, capabilities and pages

Inbox placement test API

deliverability.inbox_placement

Where a test message landed across mailbox providers: inbox, promotions or spam.
providers document it
9

Providers

9 providers document inbox placement test in their own API docs. None routes it through GridRouter yet. Scores appear as calls are routed.

What counts as a hit:
A placement result is returned for every seed.

API

Same input for every provider. Set provider.sort to route by price, reliability or latency, or provider.only to pin providers; X-Grid-Max-Cost caps what one call can spend.

Inputs for deliverability.inbox_placement
InputDescription
from_domain*Sending domain (required)
Request
curl https://api.gridrouter.io/v1/run/deliverability.inbox_placement \
  -H "Authorization: Bearer $GRID_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Grid-Max-Cost: 0.05" \
  -d '{"input":{"from_domain":"northwind.dev"},"provider":{"sort":"price"}}'

Fields

The normalized output every provider maps into. Suppliers come from integrated endpoint mappings (verified) or field names in each provider's API docs (claimed by the provider).

Every capability's fields
Output fields for Inbox placement test
FieldTypePIIDescriptionSupplied by
providerstringNoneMailbox provider (Gmail, Outlook…)Not mapped yet
placementstringNoneinbox, promotions or spamNot mapped yet
seed_emailstring · emailBusiness contactSeed addressNot mapped yet
from_domainstring · domainNoneSending domainNot mapped yet