Back to Documentation

API Reference

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.

Rate Limits

Endpoint Limit
Inbox endpoints 120 requests/minute
Search 60 requests/minute
Send email 30 requests/minute
AI endpoints 20 requests/minute

Endpoints

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).

Response Format

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

Success (200)

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

Error (4xx/5xx)

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

Ready to get started?

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

Create API Key