SMS

Sending an SMS

await nutifar.notifications.sendSMS({
  to: "+15551234567",
  body: "Your verification code is 123456",
});

to must be in E.164 format (e.g. +15551234567). Nutifar doesn't persist phone numbers — pass it on every send, same as email.

Multiple recipients

await nutifar.notifications.sendSMS({
  to: ["+15551234567", "+15557654321"],
  body: "Your verification code is 123456",
});

Templates

Like email, SMS supports templates managed from your dashboard:

await nutifar.notifications.sendSMS({
  to: "+15551234567",
  template: {
    name: "otp-code",
    data: { code: "123456" },
  },
});

Character limits and segments

Confirm this section against actual carrier/provider config before publishing — not verified against your backend.

Standard SMS messages are limited to 160 characters (GSM-7 encoding) per segment. Longer messages are automatically split into multiple segments and billed accordingly. Messages containing emoji or non-GSM-7 characters use UCS-2 encoding, lowering the per-segment limit to 70 characters.

Delivery status

Not yet confirmed — verify against actual event/webhook system before publishing.

Errors

Placeholder pending confirmation.

Error	Cause
`invalid_phone_number`	`to` isn't valid E.164 format
`unsupported_region`	SMS isn't yet supported for that country code
`carrier_rejected`	Message blocked by carrier