Developer docs

Build on the Inboxili API

Everything below is real: the endpoints, the scopes, the request bodies. For the full endpoint-by-endpoint reference — generated live from our OpenAPI schema, so it never drifts from what's deployed — open the interactive docs.

Quickstart

From signup to your first API call

1

Create your workspace

Sign up and verify a sending domain from the Deliverability Center — the API can only send from a verified sender.

2

Generate an API key

From Settings → Developer, create a key and choose the scopes it needs. The full key is shown once — store it somewhere safe.

3

Make your first request

Send it as a Bearer token on the Authorization header of any request below.

Core concepts

The modules you'll use most

Contacts

/api/v1/contacts

Create, update, tag, and suppress contacts. Lists and tags have their own endpoints for segmentation.

Campaigns

/api/v1/campaigns

Create, update, schedule, and send campaigns built from the same blocks as the visual editor.

Templates

/api/v1/templates

Reusable block-based templates you can render for both campaigns and transactional sends.

Automations

/api/v1/automations

Read and manage the multi-step journeys built in the automation editor.

Transactional email

/api/v1/transactional/send

Send a single email immediately — receipts, resets, alerts — outside the campaign pipeline.

Webhooks

/api/v1/webhooks

Register an endpoint and a set of event types; Inboxili POSTs a signed payload as each event happens.

Domains

/api/v1/domains

Verify sending domains and check DKIM/SPF/DMARC status and health score.

Developer

/api/v1/developer/keys

Create, list, and revoke API keys, and inspect a log of recent API requests.

Examples

Two more real requests

Create a contact

POST /api/v1/contacts · scope: contacts:write
curl https://api.inboxili.com/api/v1/contacts \
  -H "Authorization: Bearer ik_live_••••••••••••••••" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "ada@example.com",
    "first_name": "Ada",
    "last_name": "Lovelace",
    "custom_fields": { "plan": "growth" }
  }'

Register a webhook

POST /api/v1/webhooks · scope: contacts:write
curl https://api.inboxili.com/api/v1/webhooks \
  -H "Authorization: Bearer ik_live_••••••••••••••••" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://yourapp.com/webhooks/inboxili",
    "subscribed_events": ["delivered", "opened", "clicked", "bounced"]
  }'
Need more?

The interactive reference has every field

Request and response schemas, every status code, and a live 'try it out' console — generated straight from the deployed API.

Open interactive reference

Start Sending Smarter Emails Today

Join thousands of businesses using Inboxili to write, automate, and deliver email that performs — backed by AI and enterprise-grade infrastructure.

Switching from another platform? We'll help you migrate contacts and templates for free.