easyCoexistence
Log inStart Free Trial
Meta Tech Provider

The phone_number_name_update webhook

phone_number_name_update carries the outcome of a display name submission. Its decision field says whether Meta approved or rejected the name, and this event is the only place that outcome is reported anywhere: nothing about it appears in the WhatsApp Business app.

decision

The field carrying the approval outcome.

131037

The error a number returns when it has no approved display name.

1

Places the decision is reported: this webhook.

What it reports

The result of a display name submission, as a decision on the event. A name is what customers see above a conversation, and changing it puts it through Meta's review.\n\nWhat makes this event worth subscribing to is that nothing else says what happened. The WhatsApp Business app shows nothing, and a business that submitted a change weeks earlier has no way of knowing whether it went through unless somebody is receiving this.\n\nRecording it on a timeline turns 'did our name change go through' from a support conversation into a dated fact.

Why a name gets rejected

Principally because it does not correspond to the business the account is verified as.

  • A name matching the legal entity, a registered trading name, or the brand on the website tends to pass.
  • A generic description, or a name unconnected to the verified business, tends not to.
  • Anything that reads as a keyword rather than a name is caught consistently.

What a missing name blocks

Certain sends, which is how most people discover the name was never approved.\n\nA number without an approved display name returns error 131037 on operations that require one. That failure looks like a code fault to whoever hits it, because everything else on the number works, and it is usually traced back to a trial connection where the name step was skipped and never revisited.\n\nSubmitting a name is part of setting a number up properly rather than a cosmetic step, and it is worth doing on the day a number connects.

Common mistakes

  • Assuming no news means approved. The decision arrives here and nowhere else.
  • Submitting a keyword instead of a name. Meta checks it against the verified business.
  • Skipping the display name during a trial, then meeting 131037 on a send that needs one.
Doing this with EasyCoexistence

EasyCoexistence subscribes to this field and records each decision on the connection timeline, so an approval or a rejection is a dated event rather than something to chase.

Frequently asked questions

How long does review take?

Meta does not publish a fixed period, and no provider can accelerate it.

Can I change the name later?

Yes, and each change goes through review again, producing another event here.

Does the customer see my number too?

They see the approved display name, which is the point of having one.

What is error 131037?

What a number returns when it has no approved display name and attempts something that requires one.

Keep reading

The message_template_status_update webhookMeta reports template approvals, rejections and disabling here. What each status means and why it removes the need to poll.The message_template_quality_update webhookMeta reports a template's quality moving here, before it results in a pause. What the signal means and why it is worth acting on early.Display names on a WhatsApp business numberThe name customers see above a conversation. How approval works, what gets rejected, and which webhook reports the decision.Which numbers are eligible for CoexistenceThe app version, the account type, the portfolio access, and what actually makes Meta refuse a number during Coexistence onboarding.

Ready to get started?

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

Start Free Trial

Verified on

phone_number_name_update