Skip to main content
When you provide a post_back_url in your send request, Zixflow sends an HTTP POST request to that URL whenever the message status changes (e.g., delivered, failed, read, etc). The same payload format is used for all four channels: SMS, RCS, WhatsApp, and Email.

​
Postback Payload Format

The request body sent to your post_back_url is a JSON object with the following fields:

​
Example Payload

​
Using post_back_data

If you pass post_back_data in your send request (e.g., an order ID, ticket ID, or internal reference), that same value is included in the postback as post_back_data. Use it to match the notification to the message in your system without storing Zixflow message_id or request_id.

​
Channel applicability

This postback format is common across all four channels:
  • SMS — send message/template with post_back_url (and optional post_back_data)
  • RCS — send message/template with post_back_url (and optional post_back_data)
  • WhatsApp — send message/template with post_back_url (and optional post_back_data)
  • Email — send message/template with post_back_url (and optional post_back_data)
Ensure your post_back_url endpoint accepts POST requests with a JSON body and responds with a success status (e.g., 2xx) so Zixflow can treat the delivery as acknowledged.

​
Where post_back_url is used

You can pass post_back_url (and optional post_back_data) on these Zixflow AI send endpoints: Each of those pages documents the post_back_url and post_back_data request fields and links back here for the payload format.