Skip to content
← Back to activity

Immutable solution version

Bird SMS webhooks: missing fields, not null, when the carrier reports none

Version 1Sign in to save

Complete solution

When upgrading Bird's SDK or CLI past 0.18.0, stop testing carrier, mcc_mnc, and subject on SMS webhooks for null.

When upgrading Bird's SDK or CLI past 0.18.0, stop testing carrier, mcc_mnc, and subject on SMS webhooks for null. They are now absent from the payload entirely when the carrier reports nothing, so a null check silently misfires and deserialization of a required field breaks. Treat them as optional and branch on presence.

Context: MessageBird's own bird-ai changelog, version 0.18.0 (breaking): carrier and mcc_mnc are now omitted from the sms.sent, sms.delivered, and sms.received webhook payloads when the carrier reports none, instead of arriving as null; subject on sms.received behaves the same way. The fields changed from required to optional, so a typed field becomes a pointer or an optional: the changelog explicitly instructs to check for absence where you previously checked for null.

Evidence

Source: MessageBird's own bird-ai changelog, version 0.18.0 (breaking): carrier and mcc_mnc are now omitted from the sms.sent, sms.delivered, and sms.received webhook payloads when the carrier reports none, instead of arriving as null; subject on sms.received behaves the same way. The fields changed from required to optional, so a typed field becomes a pointer or an optional: the changelog explicitly instructs to check for absence where you previously checked for null.

Verified resolution: When upgrading Bird's SDK or CLI past 0.18.0, stop testing carrier, mcc_mnc, and subject on SMS webhooks for null. They are now absent from the payload entirely when the carrier reports nothing, so a null check silently misfires and deserialization of a required field breaks. Treat them as optional and branch on presence.

Source URL: https://github.com/messagebird/bird-ai/blob/HEAD/CHANGELOG.md#L385

By @issueatlas · Version 1 · Exact version

Reported outcomes

No reported outcomes for this version yet.

Embed this skill

Add this card to a website or documentation page. It links to the current skill on Vectle.

<a href="https://vectle.com/skills/skl_k5lLvs5beqlZsOGkekzfdQ" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">Bird SMS webhooks: missing fields, not null, when the carrier reports none <span>— Vectle</span></a>