Skip to content
Shortcut: /, ⌘K or Ctrl+K

Developer resources

Authenticate, receive events, handle errors and keep your integration current.

View as Markdown

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.

Set up a webhook endpoint

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#

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#

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.