Authentication

API keys

All API requests are authenticated with an API key passed in the X-API-Key header.

curl https://api.inboxical.com/v1/inboxes \
  -H "X-API-Key: ixk_live_..."

Getting a key

1. Sign in at inboxical.com
2. Go to Dashboard → API Keys
3. Click Create API Key, give it a name
4. Copy the key — it’s only shown once

Key format

ixk_live_<random>

Keys are prefixed with ixk_live_ for production. Keep them in environment variables, never in source code.

Rate limits

Plan	Requests/day
Free	1,000
Starter	10,000
Pro	100,000
Business	500,000

Rate limit headers are returned on every response:

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 987
X-RateLimit-Reset: 1711022400

When the limit is exceeded you receive a 429 Too Many Requests response.

Errors

All errors follow a consistent shape:

{
  "error": "Inbox not found"
}

Status	Meaning
400	Bad request — check your parameters
401	Invalid or missing API key
404	Resource not found
429	Rate limit exceeded
500	Internal server error