easyCoexistence
Log inStart Free Trial
Meta Tech Provider

WhatsApp error 131050: the user has opted out

Error 131050 means the recipient has opted out of receiving messages from your business. It is not a fault and there is no technical workaround: the person made a choice, and the correct response is to record it and stop sending.

131050

Meta's code for a recipient who has opted out of your messages.

131047

The related code for a closed 24-hour service window.

0

Technical ways to send to a recipient who has opted out.

Why there is no workaround

Because the mechanism exists to protect people from businesses that do not take no for an answer, and a platform that let it be bypassed would not be worth having on either side.\n\nMeta also watches what happens next. Continuing to attempt sends to people who have opted out contributes to the signals behind quality rating, and a falling quality rating costs messaging capacity across the whole number rather than just those recipients.

What to do instead

Record it properly, once, and let the rest of the system respect it.

  • Store the opt out against the contact so nothing tries again automatically.
  • Suppress the number across every campaign and automation, not only the one that triggered the error.
  • Do not attempt to reach them through a second business number. It is the same person and the same choice.
  • If they later message you first, the window reopens and you may reply. That is their decision to make, not yours.

Common mistakes

  • Retrying. The block is deliberate and permanent until the person changes it.
  • Suppressing only in the campaign that failed, so another one tries tomorrow.
  • Using a different number to reach the same person. It is the same choice being ignored.
Doing this with EasyCoexistence

EasyCoexistence forwards message events to your own system, so opt-outs are recorded against the contact in the place your team already works from.

Frequently asked questions

Can I message them again?

Only if they message you first, which reopens the service window.

Is there a way around it?

No, and attempting one harms your quality rating.

Does it affect my whole number?

The opt-out applies to that recipient, but repeated attempts affect your quality rating overall.

Should I remove them from my list?

Suppress them everywhere, not only in the campaign that failed.

Keep reading

WhatsApp error 131047: re-engagement messageError 131047 means more than 24 hours have passed since the customer last wrote, so free text will not deliver. What to send instead and how to avoid it.WhatsApp error 131049: message blocked for ecosystem healthError 131049 means Meta blocked the send to protect ecosystem health, not because the 24 hour window closed. Why a template does not fix it.The phone_number_quality_update webhookWhat this webhook actually carries as of 2026, why the colour quality rating is not in it, and where the rating has to be read from instead.WhatsApp Coexistence: the app and the API on one numberCoexistence runs the WhatsApp Business app and the Cloud API on the same number at once. What it changes, what it does not, and how a number gets connected.WhatsApp error 130497: recipient country not allowedError 130497 means messaging to the recipient's country is restricted for your account. What causes a country block and what can be done about it.WhatsApp error 132007: template policy violationError 132007 means a template violates WhatsApp's content policy. What the policy actually forbids and how to rewrite a rejected template.

Ready to get started?

Set up WhatsApp Coexistence in minutes, not months. The app keeps working on the phone.

Start Free Trial

Verified on

WhatsApp Error 131050