Changelog
Notable changes to the developer API (api2.freecustom.email/v1). For product-wide updates, see the main site changelog.
April 2026: Webhooks, MCP & Wait API
- Webhooks: Real-time HTTP push notifications when emails arrive. Manage endpoints directly from the API Dashboard.
- Model Context Protocol (MCP): Direct support for AI agents through the official FCE MCP server.
- Wait API: Added
wait=trueandtimeoutparameters toGET /inboxes/{inbox}/messagesfor HTTP long-polling. - Max Inboxes: Added enforced maximum active inbox limits across different pricing tiers.
March 2026: Official SDKs, AI & Yearly Billing
- AI Assistant: Built-in FCE AI introduced to help write test suites and navigate API docs.
- Official SDKs: Released Python and Node.js SDKs with native TypeScript support, automatic OTP extraction, and WebSocket connectivity.
- Yearly Billing: Introduced yearly pricing options with 2 months free across all paid API tiers.
- Global Search: Integrated high-performance global search across the documentation and landing pages.
v1 (Initial Release)
- Stable base URL:
https://api2.freecustom.email/v1 - Endpoints: /me, /usage, /plans, /inboxes, /inboxes/{inbox}/messages, /inboxes/{inbox}/otp
- WebSocket at wss://api2.freecustom.email/v1/ws
- Plans: Free, Developer, Startup, Growth, Enterprise. Credits never expire.