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=true and timeout parameters to GET /inboxes/{inbox}/messages for 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.