Skip to main content
WEBHOOK
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 by max_send_attempts failed.
  • 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 case status is failed, not expired.
Hypersender retries the push while attempts remain, so you can get this event more than once for the same message. Check send_attempt_count and max_send_attempts. See Failure reasons for the full list.

Headers

x-hypersender-event
string
required

The event name. Same as event in the body.

x-hypersender-delivery
string
required

Unique ID of this delivery attempt. A retry gets a new value, so do not use it to find duplicates.

x-instance-id
string
required

Instance ID of the SMS instance the event belongs to.

x-user-id
string
required

Your Hypersender user ID.

x-api-version
string
required

Webhook format version.

Authorization
string

Only sent when you set an Authorization Secret on the webhook. The value is your secret, exactly as you saved it. Compare it with a constant-time check.

Body

application/json
event
enum<string>
required
Available options:
message.notification.failed
data
object
required

Response

200

Return any 2xx status to acknowledge the event.

Last modified on November 20, 2026