ClientReference connects the send request to the delivery receipt (DLR).
Before you begin
You need:- A Phonovation account.
- A personal access token from developer settings.
- An approved Sender ID.
- An HTTPS endpoint configured in webhook settings if you want delivery receipts.
Check API health
The health endpoint is public:A
Check health
200 OK response containing Healthy confirms that the API is responding at that moment.Send one SMS
Submit one recipient with a Client Reference from your system:The API returns Store the UUID with the record that initiated the send. Acceptance means the campaign is queued; it does not mean the handset received the message.
Create campaign
202 Accepted with a campaign UUID:Campaign accepted
Read campaign totals
Request the campaign summary with the returned UUID:A new campaign can return
Get campaign summary
Campaign summary
404 Not Found before its summary is ready. Retry with backoff when you have just received the campaign UUID.Receive the delivery receipt
Phonovation posts the recipient-level result to your configured webhook:Verify
Delivered DLR
X-Signature against the exact raw request bytes before parsing the JSON. Use ClientReference to locate appointment-88421, apply the DLR’s Status, and return a 2xx response after storing or queueing the event.The campaign UUID tracks aggregate totals.
ClientReference tracks the individual recipient through the webhook.Go deeper
Connect the MCP server
Search the guides and API Reference directly from a compatible coding assistant.
Authentication
Compare personal access tokens with the optional OAuth lifecycle.
Sending SMS
Learn encoding, scheduling, recipient validation, and partial processing.
Webhooks
Implement signature verification, acknowledgements, and retries.