How to create an SMS error segment

Estimated 2 minute read
|
Updated Oct 24, 2024, 3:54 PM EST
You will learn

You will learn

Learn how to create a segment of SMS subscribers who are currently unable to receive your messages. This segment will be based on SMS errors, and it’s important to exclude the segment from your campaigns. 

What is an SMS error segment?

This segment groups together profiles with bad SMS data: people who were sent an SMS message, but didn’t receive it due to an error.

It’s a best practice to exclude the SMS error segment from your campaigns so that you avoid sending to those who likely won’t receive them. This is beneficial for 2 reasons: 

  1. Better SMS deliverability 
  2. More efficient use of your SMS credits
Why aren’t these users unsubscribed automatically?

In many cases, the SMS errors mentioned below are temporary, so you don’t want to unsubscribe someone right away. However, there are other errors when Klaviyo will unsubscribe the profile from SMS

Instead, you should exclude profiles with these errors from campaigns, but allow flows (and SMS conversations) to send. 

Create an SMS error segment

Create an SMS error segment

  1. Navigate to Audience > Lists & segments.
  2. Click Create New > Create segment.
  3. Name the segment (e.g., SMS errors).
  4. Add the following conditions:
    • If someone can or cannot receive SMS > can receive > SMS
      AND
    • What someone has done (or not done)
      > Failed to Deliver SMS at least once in the last 30 days
      Where Failure Type equals Device unreachable
      OR
    • What someone has done (or not done)
      > Failed to Deliver SMS at least once in the last 30 days
      Where Failure Type equals Device disconnected
      OR
    • What someone has done (or not done)
      > Failed to Deliver SMS is at least 2 over all time
      Where Failure Type equals Device unreachable
      OR
    • What someone has done (or not done)
      > Failed to Deliver SMS is at least 2 over all time
      Where Failure Type equals Device disconnected
      OR
    • What someone has done (or not done)
      > Failed to Deliver SMS at least once over all time
      Where Failure Type equals Invalid mobile number
      OR
    • What someone has done (or not done)
      > Failed to Deliver SMS is at least 5 over all time
      Where Failure Type equals Unknown error
  5. Click Create Segment.
Outcome

Outcome

You now have a segment of everyone who’s recently received an SMS error that indicates they currently can’t receive text messages.

When creating SMS campaigns, add this segment under Recipients > Don’t send to (Optional)

Campaign wizard where the Don't send to field is highlighted

Additional resources

Additional resources

Was this article helpful?
Use this form only for article feedback. Learn how to contact support.

Explore more from Klaviyo

Community
Connect with peers, partners, and Klaviyo experts to find inspiration, share insights, and get answers to all of your questions.
Live training
Join a live session with Klaviyo experts to learn about best practices, how to set up key features, and more.
Support

Access support through your account.

Email support (free trial and paid accounts) Available 24/7

Chat/virtual assistance
Availability varies by location and plan type