Documentation Navigation

API Reference

Last updated: March 1, 2026

Integrate InflowMail into your applications with our REST API.

Authentication

The InflowMail API uses API keys for authentication. Include your key in the X-API-Key header.

curl -H "X-API-Key: your-api-key" \
     https://www.inflowmail.ai/api/inbox

Keep your API key secret. Don't expose it in client-side code or public repositories.

GET /api/inbox

List emails from all connected accounts with pagination and filtering.

Query params: page, pageSize, category, timePeriod, accountIds

GET /api/inbox/{"{id}"}

Get a single email by ID, including full content.

GET /api/inbox/search

Full-text search across all emails.

Query params: query, from, to, subject, dateFrom, dateTo

POST /api/inbox/{"{id}"}/read

Mark an email as read or unread.

POST /api/inbox/ask

Ask AI questions about your emails (RAG-based Q&A).

Body: {"{ question, accountIds?, timePeriod?, maxEmails? }"}

DELETE /api/inbox/{"{id}"}

Delete an email (moves to trash on provider).

All responses are JSON. Successful responses return the data directly. Errors include a message.

{
  "emails": [...],
  "total": 150,
  "page": 1,
  "pageSize": 20
}

{
  "error": "Invalid API key",
  "code": "UNAUTHORIZED"
}

Create an API key from your account settings to start using the API.

Was this page helpful?