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.