Docs

SDKs: lightweight clients for the WillItInbox API.

Use dependency-light Node and Python clients for validation, reports, webhooks, domains, DMARC, placement, and usage workflows.

API reference Developer guide

Current SDK shape

The SDKs are intentionally small while the package story matures. They wrap the stable /api/v1 surface and can be copied into an app or published as first-party packages.

Node client: sdks/node/index.mjs using fetch.
Python client: sdks/python/willitinbox.py using the standard library.
Both clients support validation, reports, usage, webhooks, domains, DMARC, placement, and bulk workflows.

When to use an SDK

Use an SDK when you want typed-ish helpers and consistent error handling. Use direct HTTP when you need a language that does not have a first-party client yet.

REST API

Authenticated /api/v1 endpoints cover validation, bulk jobs, test inboxes, reports, webhooks, domains, DMARC, and usage.

SDKs

Dependency-light Node and Python clients live in the repo so teams can copy or package them quickly.

Webhooks

Bulk completion and monitoring workflows can POST signed events to your own endpoint for automation.