# PostalForm Projects

PostalForm Projects is a developer mail infrastructure provider.

Primary service:
- postalform/mail: project-scoped postal mail API for PDFs, letters, postcards, fulfillment, status tracking, and signed webhooks.

Stripe Projects / APP 0.1d provider base URL (this /agentic surface is the one Stripe Projects calls; legacy /stripe-projects adapter routes are internal):
- https://projects.postalform.com/agentic

Provisioning endpoints (relative to the /agentic base):
- POST /provisioning/account_requests
- GET /provisioning/services
- POST /provisioning/resources
- GET /provisioning/resources/{id}
- POST /provisioning/resources/{id}/rotate_credentials
- POST /provisioning/resources/{id}/remove
- POST /provisioning/resources/{id}/update_service
- POST /provisioning/deep_links
- GET /provisioning/health

Developer API base:
- https://projects.postalform.com/api/v1

Returned access configuration includes POSTALFORM_TEST_API_KEY, POSTALFORM_LIVE_API_KEY when live billing is enabled, POSTALFORM_WORKSPACE_ID, POSTALFORM_API_BASE, and POSTALFORM_DASHBOARD_URL.
Webhook signing secrets are endpoint-scoped. If provisioning configuration includes webhook_url, PostalForm creates or reuses that endpoint and returns POSTALFORM_WEBHOOK_ENDPOINT_ID plus POSTALFORM_WEBHOOK_SECRET for that endpoint. Credential rotations keep returning the Stripe-managed webhook endpoint variables. Otherwise developers configure webhooks later in the dashboard or with POST /api/v1/webhook-endpoints.

Test mode uses simulated fulfillment, fake credits, and never sends real mail.
Live Stripe Projects resources use usage-based billing when Stripe supplies payment_credentials.type=stripe_payment_token.
PostalForm handles production and fulfillment selection automatically based on mailpiece options and destination.

Customer webhooks are configured in the dashboard or developer API and are signed with PostalForm-Signature.

Human and machine documentation:
- https://projects.postalform.com/docs (guide and API reference)
- https://projects.postalform.com/openapi.yaml (OpenAPI 3.1 schema)
- https://projects.postalform.com/pricing (pricing calculator)