Skip to main content
POST
/
curl --request POST \ --url https://{callbackHost}/ \ --header 'Content-Type: application/json' \ --data ' { "Status": "MESSAGE_SUCCESS", "FinishedAt": "2026-04-09T14:39:40.69257Z", "Message": "Your message has been queued.", "NotifyId": "order-001" } '
Phonovation sends this webhook after it processes each recipient in a V2 campaign request. Use it for queue or rejection status. Use delivery receipts for handset delivery status.

Quick facts

ItemDetail
FormatJSON
TimingImmediately after API processing
FrequencyOnce per recipient
Success response200 OK

Status values

StatusMeaning
MESSAGE_SUCCESSMessage accepted and queued.
MESSAGE_ERRORRecipient could not be processed.
CAMPAIGN_ERRORCampaign validation failed before queueing.

Correlation

Set recipientInfo[].notifyId when sending a campaign. Phonovation returns it as NotifyId for MESSAGE_SUCCESS and MESSAGE_ERROR.

Body

application/json

Payload sent to your configured webhook URL after V2 OAuth API SMS processing completes for a recipient.

MESSAGE_SUCCESS and MESSAGE_ERROR payloads include NotifyId, which echoes the recipient notifyId value from the campaign request or an empty string if no notifyId was set.

CAMPAIGN_ERROR payloads do not include NotifyId because the error is campaign-level, although one payload is still sent per recipient.

Status
enum<string>
required

Message accepted and queued for delivery.

Available options:
MESSAGE_SUCCESS
FinishedAt
string<date-time>
default:2026-04-09T14:39:40.69257Z
required

ISO 8601 timestamp in UTC for when processing completed.

Examples:

"2026-04-09T14:39:40.69257Z"

"2025-06-06T17:50:57.675187Z"

"2025-06-06T17:55:48.6689654Z"

Message
enum<string>
default:Your message has been queued.
required

Human-readable description of the processing outcome.

Available options:
Your message has been queued.,
Sender is not valid,
Error trying to add a new message. No credits available,
null/empty MSISDN,
Error trying to add a new message to SMSBroadcastMessage
NotifyId
string
default:order-001
required

The recipient notifyId from the campaign request, or an empty string if no notifyId was set.

Examples:

"order-001"

""

Response

200

Your webhook endpoint accepted the SMS processing result payload.

Last modified on June 10, 2026