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.
- OTP vs marketing route split on one prepaid account
- SMS second corridor: handover owners before you add volume
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
- Campaign ETA vs wall-clock: quiet hours eat the forecast
Learn how wall-clock time, quiet hours rules, and throughput pacing alter your SMS campaign ETA. Keep your white-label platform precise.
- Retry failed SMS campaign items without double-delivering
Safe requeue of failed items in white-label prepaid SMS campaigns without rebilling delivered messages.
- Balance Guard Pauses SMS Campaigns: Low Wallet Is Not Provider Down
Discover why unexpected SMS campaign halts on our white-label CPaaS platform stem from prepaid balance floors rather than carrier outages.