Docs·API Reference

API Reference

RESTful, JSON, Bearer token auth. Access your requests, integrations, and webhook events programmatically.

Authentication

All API requests require a Bearer token. Generate an API key from your dashboard under Settings → API Keys.

Request header

Authorization: Bearer mb_live_xxxxxxxxxxxxxxxxxxxx

https://app.mailbridge.ai/api

GET/api/requests

List all inbound email requests. Supports cursor-based pagination.

Query params

limitnumber

Max results to return (default 20, max 100).

cursorstring

Pagination cursor from the previous response.

statusstring

Filter by status: open | closed | all.

GET/api/requests/:id

Retrieve a single request by ID, including full email body and triage result.

GET/api/integrations

List all active integrations (Slack, Discord, Linear, ClickUp) for the authenticated org.

GET/api/webhook-events

List recent webhook event delivery attempts and their status.

Query params

limitnumber

Max results to return (default 20).

The API is rate-limited per API key. Limits are returned in response headers on every request.

PlanRequests / minRequests / day

Starter605,000

Professional30050,000

Rate limit headers: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.