# Postbox

> Postbox is an agent-native structured data collection platform. Forms are the base unit - a well-defined collection of fields that expresses intent. A contact form can be name, email, message. A bug report form can be title, reproduction steps. Create a form by defining the schema, get an endpoint, and start receiving validated submissions from HTML forms, scripts, or AI agents. No backend to build, no database to manage, no validation to write.

Postbox is the post-submit layer. You own your frontend (or don't have one at all). Postbox owns what happens after submit: validate, filter spam, translate, reply. Every submission runs through a configurable async pipeline - schema validation, spam detection (heuristic or AI-powered), auto-translation, and AI smart replies grounded in your knowledge base.

Two API calls to go from nothing to a working endpoint: create a form with a field schema, then POST data to the returned endpoint URL. Public forms require no authentication to submit. The endpoint always responds 201 immediately; all processing is async.

Two interfaces: a REST API with Bearer token auth (all plans) to create forms, collect submissions, configure processing pipelines, and integrate with your systems via webhooks and connectors. An MCP Server with OAuth 2.1 (Pro plan) to connect AI assistants directly to your data - build custom workflows, explore submissions conversationally, spot patterns, and draft replies from any MCP client.

API endpoints: POST/GET/PUT/DELETE `/api/forms` and `/api/forms/{id}` for form management, GET/DELETE `/api/forms/{id}/submissions/{id}` for submission management, POST `/api/{opaque_segment}/f/{slug}` to submit data (public), GET `/api/{opaque_segment}/f/{slug}` to discover form schema (public). Authentication via `Authorization: Bearer {api_key}` - generate keys at https://usepostbox.com/integrations/api-keys

MCP tools (Pro plan, endpoint `https://usepostbox.com/mcp`): list_forms, get_form, list_submissions, get_submission, get_dashboard_stats, translate_submission, analyze_spam, draft_reply, summarize_submissions.

Pricing: Free plan includes 1 form, 5,000 lifetime submissions, and 50 AI credits (one-time). Pro plan ($19/mo or $199/yr) includes unlimited forms and submissions, MCP access, 500 AI credits/month with metered overflow. AI credit costs: spam detection $0.005, translation $0.005, smart reply $0.01. Standard spam protection (heuristics, honeypot, content moderation) is always free.

## Docs

- [Full API Reference](https://usepostbox.com/llms-full.txt): Complete REST API documentation with request/response examples, field schemas, webhook setup, and integration guides
- [Documentation](https://docs.usepostbox.com): Guides, concepts, and step-by-step tutorials

## Optional

- [Features](https://usepostbox.com/features): Feature overview
- [Pricing](https://usepostbox.com/pricing): Plans and pricing details
- [Blog](https://usepostbox.com/blog): Product updates and technical guides