Changelog

Changes to the Messaging and Airtime APIs and their webhooks, newest first. A deprecated field still works. Its replacement is named beside it.

Deprecated fields

Field	Where	Use instead	Since
Top-level `message`, `code` and `errors` on an error	Every error body	`error.message`, `error.code` and `error.details`. See Errors.	29 October 2026
`content`	Send a message	`text`, or the field named after the message's type, such as `image`	19 October 2026
`templateId` and `templateParameters`	Send a message	`template`, with `id`, `body` and `buttons`	19 October 2026

Every error has a code. An error answers with an error object: type, code, name, message, doc_url and request_id, and on a validation error details. See Errors. The older top-level fields are deprecated and still sent.
Why a message wasn't delivered. A message that ends as EXPIRED, UNDELIVERED or FAILED carries a failureCode (an E11 code) beside failedReason.
customerCharge is gone from messages and webhook events. Read cost, which held the same number.

One base URL for each kind of key. Live keys work only at https://api.ponitor.com and sandbox keys only at https://sandbox-api.ponitor.com. A key sent to the other one is refused with 401. See API keys and base URLs.

Workspaces. Send workspace, a workspace's handle, on Send a message and Buy airtime or data to send from it and charge it. See Workspaces.

Data bundles have a stable id (prod_…) and a readable code. Buy by productId, productCode or both. A bundle's data and validity are text, such as 1.8GB and 7 days.
expectedPrice on a bundle purchase refuses it with 409 (E03004) if the price has changed.

Data bundles on the Airtime API. List data bundles, get one, and buy one with Buy airtime or data.

The message in a field named after its type. Send text, image, video, audio, document or template, and read the message the same way. content, templateId and templateParameters still work.
More WhatsApp messages: stickers, locations and contact cards; reply buttons, lists and link buttons; and Mark a message read.
smsFallback sends an SMS when the number isn't on WhatsApp. See If they're not on WhatsApp.

Airtime: at least $1.00 per purchase, and at most your team's limit per recipient.