IOSOR Learn

Suppressions in campaigns: skipped is not failed on the ledger

Learn how prepaid CPaaS platforms process pre-flight suppressions without impacting balance holds, delivery metrics, or financial ledger reconciliation.

Suppressions in campaigns: skipped is not failed on the ledger.

Understanding pre-flight suppressions in broadcast campaigns

When executing multi-recipient SMS campaigns across dynamic customer lists, managing opt-outs is both an operational necessity and a regulatory requirement. When an end recipient submits a STOP keyword, their phone number in E.164 format is appended to the local suppression database. During subsequent campaign dispatches, the platform evaluates every target destination against this list before sending payloads to upstream carrier routes.

Distinguishing SKIPPED from FAILED on the billing ledger

A common source of confusion in campaign reconciliation is grouping skipped messages together with network delivery failures. A network failure happens after a message is dispatched to upstream routes, whereas a skipped status occurs before any network interaction. When a message fails upstream due to network congestion, invalid SMSC routing, or subscriber unreachability, a delivery receipt (DLR) reports an error code, and any temporary hold transitions into a permanent charge or partial refund based on contract terms. SKIPPED records, however, never incur a network cost.

Prepaid wallet holds and real-time execution semantics

For platforms running on prepaid architecture, campaign dispatches initiate a temporary balance authorization. When a batch contains 10,000 targets, the engine calculates the estimated authorization hold based on valid, non-suppressed destinations. If 1,000 destinations are flagged as suppressed, the system immediately excludes them from the prepaid hold calculation. Consider a campaign with a baseline cost of USD 20 per thousand dispatches.

Audit trails and observability across platforms

When monitoring campaign dispatches via webhooks or real-time dashboards, platform administrators must align status codes across product and finance views. Detailed status tracking ensures that operations teams can differentiate between silent carrier drops—such as those described in sent is not inbox—and administrative skips. Webhook payloads for SKIPPED events include explicit metadata attributes identifying the precise suppression rule triggered, such as global opt-out or manual blocklist entry.

Exporting clean operational data for enterprise finance

Finance teams reconciling monthly billing exports require clear separation between route charges and pre-flight exclusions. Including skipped records in billing line items inflates message count totals and causes artificial discrepancies between system logs and invoice balances.

Start with IOSOR

Access the IOSOR console to review your campaign pre-flight gate rules and ensure locally suppressed numbers are flagged as SKIPPED prior to authorization hold calculations. Verify your outbound webhooks and billing export templates map SKIPPED records to zero-cost events rather than network failure payloads. Re-run your enterprise reconciliation reports to confirm wallet hold amounts match only valid, non-suppressed outbound destinations.

IOSOR takeaway

Pre-flight suppressions safeguard your budget and sender reputation by filtering out opt-out records before network dispatch. Marking these records as SKIPPED on the ledger keeps message volume metrics clear, proving that no network routing attempt occurred and no wallet authorization hold was captured.

Do separate pre-flight SKIPPED events from post-dispatch FAILED DLRs in your automated financial exports and real-time observability dashboards. Don't classify locally suppressed records as carrier delivery failures, as doing so inflates error metrics and obscures true route performance on your balance sheet.

Was this guide helpful?

Related guides