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

Base URL

https://app.usemailbridge.com/api

Endpoints

GET/api/conversations

List your org's conversations. Paginated and filterable.

Query params

statusstring

Filter by status: open | resolved | ignored.

categorystring

Filter by AI category (e.g. bug_report, billing).

prioritystring

Filter by priority: urgent | high | medium | low.

searchstring

Search by subject or customer email.

sortstring

Sort order: newest (default) | oldest | priority.

pagenumber

Page number (default 1).

limitnumber

Results per page (default 20, max 100).

GET/api/conversations/:id

Retrieve a single conversation by ID, including all messages and AI triage results.

PATCH/api/conversations/:id

Update a conversation's status.

Query params

statusstring

Body param. New status: open | resolved | ignored.

POST/api/conversations/:id/reply

Send an email reply to the customer from your org's sending identity.

Query params

contentstring

Body param. Plain-text reply content (required).

GET/api/integrations

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

GET/api/webhooks/logs

List recent outbound webhook delivery logs (last 100). Filterable by endpoint.

Query params

endpointIdstring

Filter logs to a specific webhook endpoint ID.

Rate limits

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

PlanRequests / minRequests / day

Starter605,000

Growth12015,000

Professional30050,000

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