---
title: "Troubleshoot WhatsApp message delivery errors"
description: "Identify and fix WhatsApp delivery errors to improve message performance and protect your sender reputation."
canonical_url: "https://help.klaviyo.com/hc/en-us/articles/42141066963355"
markdown_url: "https://help.klaviyo.com/hc/en-us/articles/42141066963355.md"
locale: "en-us"
category: "WhatsApp"
section: "Understand WhatsApp with Klaviyo"
updated: "2026-11-03"
---

# Troubleshoot WhatsApp message delivery errors

**📋 Requirements:** WhatsApp must be enabled in your Klaviyo account to access delivery data.

Identify and fix WhatsApp delivery errors to improve message performance and protect your sender reputation.

## Before you begin

Follow these steps to check your WhatsApp delivery results:

1. For a campaign, go to **Campaigns** and open the sent campaign, then open its WhatsApp message report. For a flow, go to **Flows**, open the flow, select its WhatsApp message, and click **View details**.

2. On the **Overview** tab, review the **Deliverability** section.

3. Select **Recipient activity > Failed** and review the **Failed Reason** column.

4. Open a recipient’s profile and expand the **Failed to Deliver WhatsApp** event for the message. Find **Vendor Error Code** in the event details.



If your delivery rate is below 90%, or you see repeated error codes, review the table below and set up the WhatsApp error segment.

## Common WhatsApp error codes

Use the following table to identify common WhatsApp error codes and how to resolve them.

| Error code | Description | Recommended action |
| --- | --- | --- |
| 131026 – Message undeliverable | WhatsApp couldn’t deliver the message. Common causes include invalid WhatsApp numbers, missing country codes, or outdated Terms of Service. | • Verify phone number format and country code. • Ask users to update WhatsApp and accept the latest Terms. • Remove invalid or inactive numbers. |
| 131053 – Media upload error | The media file in your message couldn’t be uploaded. | • Check file format and compression. • Supported formats: Images (8-bit RGB/RGBA), Videos (H.264 + AAC), Documents (PDF for template headers). |
| 130472 – Number in experiment | WhatsApp is running experiments that may limit marketing messages to certain users. | • Contact users through another channel and ask them to message your business on WhatsApp. • Resume marketing messages within 24 hours once they respond. |
| 131049 – Maintain healthy ecosystem engagement | WhatsApp blocked delivery due to low engagement or frequent marketing messages. | • Avoid immediate retries. • Reduce frequency and send to engaged users. • Personalize messages to encourage replies. |
| 131050 – Recipient opted out | The recipient turned off marketing messages from your business in WhatsApp. | • Do not resend marketing messages. • Klaviyo automatically unsubscribes the profile from WhatsApp marketing when it receives error 131050. • The recipient must turn marketing messages from your business back on in WhatsApp before receiving them again. |
| 131000 – Unknown error | Temporary or general delivery failure. | • Retry later. • Contact Klaviyo Support if it persists. |

## Why use the WhatsApp error segment

Repeated delivery failures reduce performance and damage your sender reputation. The WhatsApp error segment identifies contacts that meet the failure conditions below so you can exclude them from future WhatsApp campaigns. For details on which messages are charged, see [Understand WhatsApp billing in Klaviyo](https://help.klaviyo.com/hc/en-us/articles/40116442241179.md).

This segment must be added manually. It is not automatically applied to campaigns.

## When to use it

- Delivery rates are below 90%.

- Errors like 131049, 131026, or 130472 appear frequently.



## How to create the WhatsApp error segment

1. Go to **Audience > Lists & segments** and select **Create > Segment**. Name the segment, for example, WhatsApp delivery errors. If a naming panel opens, click **Create segment** to continue to the builder.

2. Set conditions:

   - Select **If someone can or cannot receive marketing**, then choose **can receive** and **whatsapp marketing**.

   - Join the consent condition with **AND** to a group of **What someone has done (or not done)** conditions. Join the 3 failure conditions below to one another with **OR**:

     - **Failed to Deliver WhatsApp** > **at least once** > **in the last** 16 **days**, where **Vendor Error Code** **equals** 131049.

     - **Failed to Deliver WhatsApp** > **at least once** > **over all time**, where **Vendor Error Code** **equals** 131026.

     - **Failed to Deliver WhatsApp** > **is greater than** 2 > **over all time**, where **Vendor Error Code** **includes any of** 130472 and 131049.

3. Click **Create segment** to save the definition.

4. In each WhatsApp campaign’s audience settings, select this segment under **Don't send to**. Click **Next**, or **Save and return** if you opened the audience from the campaign canvas, to save the exclusion.



![Creating segment conditions in Klaviyo](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/fed0387fdac4815e66c3092a8264108ae9188296-3258x1077.png?auto=format)

## Best practices

- Always exclude the WhatsApp error segment before you send a campaign.

- Regularly review delivery performance and error trends.

- Remove invalid or inactive contacts from your lists.

- Focus on engaged users to maintain a strong sender reputation.
