The Inboundr REST API is a small, predictable JSON API. Every endpoint is authenticated with a bearer token, returns JSON, and uses standard HTTP status codes.

Base URL

Conventions

  • Requests — send JSON with Content-Type: application/json.
  • Auth — every request needs an Authorization: Bearer inb_… header. See Authentication.
  • Responses — always JSON. List endpoints wrap results in { "data": [...] }; paginated lists also include nextCursor.
  • Errors — non-2xx responses carry an error field. See Errors.
  • Timestamps — ISO 8601 UTC strings (e.g. 2026-07-20T10:30:00.000Z).

Object ids

Ids are prefixed by type, so they’re self-describing:

Resources

Domains

Addresses

Endpoints

Emails

Threads

Attachments