TrulyInbox Open API

The TrulyInbox Open API provides programmatic access to manage your email accounts, control warmup settings, monitor deliverability health scores, and retrieve warmup activity reports for accounts within your workspace.

Base URL

All API requests should be made to:

https://lupus-edge.trulyinbox.com/v1

Authentication

Every API request must include your API key in the X-Api-Key header.

Get Your API Key

Log in to your TrulyInbox account
Navigate to Settings → API
Generate and copy your API key

Example Request

curl -X GET "https://lupus-edge.trulyinbox.com/v1/email-accounts" \
  -H "X-Api-Key: YOUR_API_KEY"

Security Note: Keep your API key secure. Do not expose it in client-side code or public repositories.

Response Format

All responses are returned in JSON format.

Example Error Response

{
  "error_code": "not_found",
  "message": "Email account not found.",
  "details": {}
}

Rate Limiting

Each API key is limited to 20 requests per minute. Exceeding this limit will result in a 429 Too Many Requests response.

Every response includes the following headers:

Header

Description

X-RateLimit-Limit	Requests allowed per window (20 per API key)
X-RateLimit-Remaining	Requests remaining in the current window
X-RateLimit-Reset	Unix timestamp when the window resets

Use the following endpoint to check your current rate limit status without consuming quota:

GET /v1/rate-limit

What You Can Do

Email Accounts
Connect, disconnect, list, get status, bulk status, delete, and bulk delete email accounts

Warmup
Start or stop warmup, get and update warmup settings, perform bulk actions, and view activity history

Deliverability
Get setup score, refresh setup score, and run DNS health checks

Reports
Fetch single account reports, bulk reports, export reports, and access account-wide data

System
Check API health and rate limit status

Help center