Firsty

Search...

Search...

Webhooks

SMS events

Signed POST requests to your webhook endpoint for SMS events. See the Webhooks overview for signature verification.

SMS Sent

sms.sentExperimental

Triggered when an SMS notification was handed to the mobile network for the eSIM's customer. It reports the SMS as sent, not as received by the device.

Payload

typestring
Optionssms.sent
timestampstring · date-time

When the event was recorded. This can be later than the change it reports: usage reported by the network can describe consumption that happened earlier.

dataobject
Show properties
profileReferencestring
esimReferencestring

eSIM reference

iccidstring
typestring

Extensible enum. What the SMS notified the customer of: the eSIM entering a country, or the package event of the same name.

Examplescountry.entrypackage.activatedpackage.usage.thresholdpackage.throttledpackage.exhausted
thresholdPercentintegeroptional

The usage threshold the SMS reports. Sent only when type is package.usage.threshold.

payloadstring

The text of the SMS as sent.

sms.sent
{
  "type": "sms.sent",
  "timestamp": "2026-01-24T14:30:00Z",
  "data": {
    "profileReference": "1234567890123456",
    "esimReference": "123456000000000001",
    "iccid": "89012345678901234567",
    "type": "country.entry",
    "thresholdPercent": 80,
    "payload": "Je hebt 80% van je bundel gebruikt."
  }
}