FAQ

Answers to the most common questions about AgentInbox.

General Questions

What is AgentInbox?+
AgentInbox is an API-first email platform designed for AI agents and automated workflows. It provides temporary email inboxes, real-time email processing, and structured data extraction.
How long do inboxes last?+
Inboxes have a configurable time-to-live (TTL) from 1 second up to 7 days. After the TTL expires, the inbox and all its messages are automatically deleted.
Can I receive HTML emails?+
Yes. The API returns both plain text and HTML versions of the email body, as well as the raw MIME content for advanced use cases.
What extraction types are supported?+
AgentInbox supports 8 built-in extraction types: OTP, magic links, verification codes, invoice numbers, tracking numbers, API tokens, coupon codes, and password reset links. Additionally, LLM-powered fallback can extract any other structured data.

Billing & Plans

Is there a free tier?+
Yes. The free tier includes 60 API requests per minute, 10 active inboxes, and 50 LLM extractions per month. No credit card required.
How do I get an API key?+
Sign up at agentinbox.in, go to your dashboard, and generate an API key under Settings. API keys start with at_live_.

Integrations

Can I use AgentInbox with Claude, Cursor, or other AI agents?+
Yes. AgentInbox provides an MCP server that exposes 12 tools for AI agents. See the MCP Server documentation for setup instructions.
What programming languages are supported?+
AgentInbox provides official SDKs for Node.js (TypeScript/JavaScript) and Python. You can also use any language that supports HTTP requests with the REST API.

Security & Reliability

Are webhooks secure?+
Yes. Webhooks are signed with HMAC-SHA256 using a secret you provide. You should verify the signature on your endpoint to ensure events are genuine. See the Security documentation.
What happens if a wait times out?+
If a wait reaches its timeout without receiving a matching email, the status changes to timed_out and the result is null. You can retry or cancel the wait as needed.
Can I attach metadata to inboxes?+
Yes. You can attach any JSON object as metadata when creating an inbox. This is useful for tagging, tracking, and filtering inboxes in your workflows.
How do I handle rate limits?+
The API returns rate limit headers with every response. If you hit a limit, you'll receive a 429 status code. Implement exponential backoff and consider using webhooks instead of polling. See Rate Limits.

Still have questions?

Check the troubleshooting guide or contact support through the dashboard.

Related Documentation