{
"event": "message.notification.failed",
"data": {
"user_id": "9f8b7c6d-2222-4a2b-8c3d-4e5f6a7b8c9d",
"phone_id": "9f8b7c6d-1111-4a2b-8c3d-4e5f6a7b8c9d",
"id": "9f8b7c6d-3333-4a2b-8c3d-4e5f6a7b8c9d",
"request_id": "order-1042-otp",
"phone": {
"id": "9f8b7c6d-1111-4a2b-8c3d-4e5f6a7b8c9d",
"user_id": "9f8b7c6d-2222-4a2b-8c3d-4e5f6a7b8c9d",
"push_registration": {
"status": "registered",
"recovery_required": false,
"synced_at": "2026-11-19T08:00:00+00:00",
"client_state": "registered"
},
"app_update_required": false,
"app_update_reason": null,
"phone_number": "+12025550101",
"name": "Office phone",
"sim": "SIM1",
"max_send_attempts": 3,
"message_expiration_seconds": 0,
"is_online": false,
"last_online_at": "2026-11-19 08:00:00",
"last_offline_at": "2026-11-18 22:10:00",
"last_message_at": "2026-11-19 10:00:01",
"last_missed_call_at": null,
"last_heartbeat_at": "2026-11-19 09:55:00",
"heartbeat_enabled_at": "2026-11-19 08:00:00",
"timezone": "UTC",
"created_at": "2026-10-01 09:00:00",
"updated_at": "2026-11-19 10:00:01"
},
"message_thread_id": "9f8b7c6d-4444-4a2b-8c3d-4e5f6a7b8c9d",
"from_phone_number": "+12025550101",
"to_phone_number": "+12025550147",
"content": "Acme code: 482913",
"tags": [],
"send_duration": null,
"schedule_on_phone_at": null,
"sent_at": null,
"last_attempted_at": "2026-11-19 10:01:20",
"delivered_at": null,
"received_at": null,
"expired_at": null,
"schedule_send_at": null,
"failed_at": "2026-11-19 10:01:30",
"send_attempt_count": 3,
"max_send_attempts": 3,
"failure_reason": "Max send attempts reached",
"ussd_message": null,
"message_expiration_seconds": 600,
"timezone": "UTC",
"sim": "SIM1",
"status": "failed",
"type": "sent_to_mobile",
"created_at": "2026-11-19 10:00:00",
"updated_at": "2026-11-19 10:01:30"
}
}Message Push Failed
Sent when Hypersender could not push a message to the phone.
WEBHOOK
message-notification-failed
{
"event": "message.notification.failed",
"data": {
"user_id": "9f8b7c6d-2222-4a2b-8c3d-4e5f6a7b8c9d",
"phone_id": "9f8b7c6d-1111-4a2b-8c3d-4e5f6a7b8c9d",
"id": "9f8b7c6d-3333-4a2b-8c3d-4e5f6a7b8c9d",
"request_id": "order-1042-otp",
"phone": {
"id": "9f8b7c6d-1111-4a2b-8c3d-4e5f6a7b8c9d",
"user_id": "9f8b7c6d-2222-4a2b-8c3d-4e5f6a7b8c9d",
"push_registration": {
"status": "registered",
"recovery_required": false,
"synced_at": "2026-11-19T08:00:00+00:00",
"client_state": "registered"
},
"app_update_required": false,
"app_update_reason": null,
"phone_number": "+12025550101",
"name": "Office phone",
"sim": "SIM1",
"max_send_attempts": 3,
"message_expiration_seconds": 0,
"is_online": false,
"last_online_at": "2026-11-19 08:00:00",
"last_offline_at": "2026-11-18 22:10:00",
"last_message_at": "2026-11-19 10:00:01",
"last_missed_call_at": null,
"last_heartbeat_at": "2026-11-19 09:55:00",
"heartbeat_enabled_at": "2026-11-19 08:00:00",
"timezone": "UTC",
"created_at": "2026-10-01 09:00:00",
"updated_at": "2026-11-19 10:00:01"
},
"message_thread_id": "9f8b7c6d-4444-4a2b-8c3d-4e5f6a7b8c9d",
"from_phone_number": "+12025550101",
"to_phone_number": "+12025550147",
"content": "Acme code: 482913",
"tags": [],
"send_duration": null,
"schedule_on_phone_at": null,
"sent_at": null,
"last_attempted_at": "2026-11-19 10:01:20",
"delivered_at": null,
"received_at": null,
"expired_at": null,
"schedule_send_at": null,
"failed_at": "2026-11-19 10:01:30",
"send_attempt_count": 3,
"max_send_attempts": 3,
"failure_reason": "Max send attempts reached",
"ussd_message": null,
"message_expiration_seconds": 600,
"timezone": "UTC",
"sim": "SIM1",
"status": "failed",
"type": "sent_to_mobile",
"created_at": "2026-11-19 10:00:00",
"updated_at": "2026-11-19 10:01:30"
}
}Event:
message.notification.failed
Sent when Hypersender could not push a message to the phone, so the phone never got it. status is failed. Common failure_reason values:
Max send attempts reached: every attempt allowed bymax_send_attemptsfailed.Phone does not have an FCM token. Open the Android app to register push notifications.: the phone is not registered for push notifications. Open the app on the phone so it registers again.MAX_ATTEMPTS: the send job gave up before the message reached the phone.Message expired: the message expired before it could be pushed to the phone. In this casestatusisfailed, notexpired.
send_attempt_count and max_send_attempts.
See Failure reasons for the full list.Headers
Body
application/json
Response
200
Return any 2xx status to acknowledge the event.
Last modified on November 20, 2026