WhatsApp access token: what it is and when it expires

Learn what your WhatsApp channel's access token is, why the dreaded code 190 error shows up, and how to refresh it by reconnecting the channel.

Jun 25, 2026

What the access token is

Every WhatsApp channel you connect in Omnifox stores an access token: a credential Meta gives us so we can send and receive messages on your behalf. We fetch it automatically when you connect the number, whether through Coexistence or Cloud API, and it's kept encrypted in the channel settings. You never have to copy or paste it by hand.

In short: the token is the "key" to your number. If it expires or is revoked, Omnifox stays linked but Meta stops accepting your messages.

When a token expires

A token can stop working for several reasons:

  1. Expiry: tokens from the Embedded Signup session have a limited lifetime. System User tokens can be set to never expire.
  2. Revocation: someone changed the Facebook password, removed the app's permissions, or disconnected the number from Meta's Business Manager.
  3. Permission changes: if whatsapp_business_messaging or whatsapp_business_management are withdrawn, the token stops working.

The code 190 error

When a token expires or is revoked, Meta answers every send attempt with an authentication error: code 190 (OAuthException). Typical symptoms:

  • No templates or messages go out from the channel (it's not a single message — they all fail at once).
  • In Settings → Channels the channel shows the Error status.
  • Inside the conversation you see a notice that the message couldn't be delivered.

Important: code 190 can also appear during a temporary Meta outage even when your token is still valid. If EVERY channel across ALL accounts fails at the same time and then recovers on its own, it's usually a Meta outage, not your token. Check Meta's status page before reconnecting.

How to refresh the token

The right way to refresh the token is to reconnect the channel, which repeats the connection flow and stores a fresh token:

  1. Go to Settings → Channels and click Connect New Channel.
  2. Pick WhatsApp and type a channel name.
  3. Click the same card you used the first time (Connect with WhatsApp for Coexistence, or Migrate my number / Create a new number for Cloud API) and complete the Meta window with the same account and the same number.
  4. Confirm the channel status switched to Connected.

There is no “Reconnect” button inside the channel, and even though the button says “connect new channel” no duplicate is created: Omnifox recognises the number by its Phone Number ID and updates the existing channel with the fresh token.

Verify it worked

After reconnecting, send a test to a contact with an open 24-hour window, or send an approved template. If it arrives, the new token is active. The channel health check will turn green again.

If it doesn't work

  • Still in Error after reconnecting: make sure you signed in to the right Facebook account and that the Omnifox app still has its permissions in Business Manager.
  • Only templates fail, chats are fine: that isn't code 190; check the template's status in Meta.
  • Account managed by your provider (own Cloud API): an admin can load a permanent System User token in the channel's manual mode.

Tips

  • Use a System User token that never expires for critical numbers to avoid surprise renewals.
  • Keep more than one Business Manager admin so nobody gets locked out.

Related articles

Was this helpful?

Related articles

Message us on WhatsApp