Developer resources
Authenticate, receive events, handle errors and keep your integration current.
Every Polymorfa integration uses the same building blocks: a credential, the Messaging and Platform APIs at https://api.polymorfa.com, events delivered to your server, and a pinned API version. Start with the webhooks quickstart if your integration needs to react to messages or Number changes.
Keys and credentials#
- Authentication: choose between a team key, a project token and a client token.
- API keys: create, scope, rotate and revoke team keys and project tokens.
- Client tokens: give a browser or app narrow, short-lived access to one Number.
Events and webhooks#
- Webhooks quickstart: create an endpoint, verify signatures and send a test event.
- Webhooks: configure formats, retries and delivery inspection.
- Types of events: look up every event Polymorfa sends and its payload.
- Event history: list past events and read their payloads.
- Stream events: read a project's events over a server-sent event stream.
Errors and retries#
- Error handling: read the error object, decide when to retry and find a request in the logs.
- Idempotency: retry writes without repeating them.
- Errors: look up every error code and its fix.
- Rate limits: read quota headers and back off after a
429. - Operations: follow and cancel asynchronous work.
Versioning#
- Upgrade your integration: pin
Polymorfa-Versionand move to a newer version. - API versioning: see how the version header is resolved.
- Changelog: read what changed and when.
- Feature availability: check which features your team can use.
Tools#
- CLI: call the API, forward events to your machine and trigger test events.
- CLI API requests: send any API request from the terminal.
- MCP server: connect AI agents to your Numbers and team.
Logs and monitoring#
- Request logs: find an API request by status, route or request ID.
- Logs: inspect requests, deliveries and session changes in the Console.
- Drains: send project logs or hourly Number analytics to your endpoint.
- Log forwarding: forward sampled operational records to your endpoint.
Security#
- Security: keep credentials, webhooks and data within their boundaries.