Skip to main content
SMS message reports give you delivery statistics, engagement metrics, and recipient-level detail for each message you send. Reports are available for both SMS/MMS and RCS messages.

Metrics reference

Message-level metrics

Report-level metrics

For metric definitions across all channels, see the Metrics glossary.

Data retention

SMS messages and related report data are retained for approximately 30 days. Export message or audience data if you need long-term records. See Exporting data.

Conversions

This report shows the conversions attributed to and influenced by this message. See Conversion metrics for the attribution model and setup instructions.

Understanding SMS failures

When troubleshooting deliverability, look at the exact error text in Audience Activity. Other numeric codes can appear. Search the Twilio errors index for the code shown in Audience Activity. OneSignal SMS uses Twilio infrastructure, so these codes apply to both setups.

Messages with no error text

Some failures return no error text or an empty reason field when the carrier or provider does not supply a detailed code. In the dashboard, these often roll up under Failed to Send. Recommended steps:
  1. Confirm the number is valid E.164 and the subscription is SMS-eligible and not opted out.
  2. Retry after a delay in case of transient provider or carrier issues.
  3. If the issue is widespread, collect example message or delivery SIDs and contact OneSignal support.

Billing

OneSignal SMS customers

View your usage under Settings > Usage > SMS > See breakdown. The breakdown shows segments (not messages) sent by message type, filterable by country. The breakdown is updated daily. The count includes all outbound segments, including auto-replies sent in response to consent keywords (STOP, HELP, START) or other custom keyword replies. Failed messages are not included in the segment count.

Twilio integration customers

You pay Twilio directly. For billing questions, see your Twilio dashboard.

FAQ

Why does my delivery rate show lower than expected?

Common causes include invalid phone numbers, opted-out subscribers (showing as Suppressed), carrier-side content filtering, or registration issues (showing as Rejected or Provider Errored). Check the error text in Audience Activity for the specific cause.

What’s the difference between Failed and Rejected?

Failed means OneSignal could not send the message to the carrier at all. Rejected means the carrier received the message but did not deliver it, typically due to number blockage, velocity limits, or the recipient being on a block list.

How long are message reports available?

SMS message reports and audience activity data are retained for approximately 30 days. Export your data if you need longer retention.

Can I see which individual subscribers received a message?

Yes. The Audience Activity section of each message report shows recipient-level delivery and engagement details, including any error codes for failed messages.

Why do some messages have no error code?

Some carriers and providers do not return detailed error codes for failed deliveries. These show up as empty in Audience Activity. If you see widespread failures with no error detail, collect the message SIDs and contact OneSignal support.

Composing messages

Encoding, segment math, MMS limits, and how content affects billing.

SMS opt-in and collection

Audience validation and phone number format requirements.

Exporting data

Export delivery and engagement data for long-term retention.

Links

How OneSignal tracks clicks in SMS, MMS, and RCS messages.