Error shown when connecting number "For API Version 21 and above, please first call settings endpoint"

Error when registering number

Message displayed: "For API Version 21 and above, please first call settings endpoint"

Image #1 – Example of the error

This error happens on newer versions of the WhatsApp Cloud API (v21+), when the mandatory settings endpoint hasn’t been called yet for the number before registration (/register).

What we need to get first

You’ll need 3 pieces of information:

• PhoneNumberID

• Connection token

• Country code (ISO 3166-1 alpha-2)

How to get the PhoneNumberID and the Token

They can be captured by the browser:

1. Open the panel where the connection issue is happening

2. Press F12

3. Go to the Network tab

4. Repeat the Manage connection action

5. Find the request

6. Inside it you’ll find:

   • PhoneNumberID

   • Access Token

On Mac:

• Right click → Inspect

Country code

The code needs to follow the ISO 3166-1 alpha-2 standard

Example:

• Brazil = BR

For other countries, check the list: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2

(Use the value from the "Code" column)

Image #2 – Screenshot of the ISO list

How to fix it using ReqBin

Go to: https://reqbin.com

Use method POST with the URL:

https://graph.facebook.com/v24.0/_phoneNumberID_/settings?access_token=_token_

Replace:

• _phoneNumberID_ → with the phoneNumberID of your connection, taken from F12

• _token_ → with the token taken from F12 (or by creating an app, check out our tracking tutorial that teaches this)

JSON to send

{ "storage_configuration": { "status": "IN_COUNTRY_STORAGE_ENABLED", "data_localization_region": "CodigoDoPais_Em_ISO_3166_1_alpha_2_code" } }

Image #3 – Insert PhoneNumberID, Token and country code (e.g.: BR)

Expected result

After clicking on SEND in ReqBin:

If it appears in green: 200 (OK)

This means that:

• The configuration was applied correctly

• The number can now be connected again

Now just repeat the connection process in the CRM.

If there’s an error

If it returns another error:

• Check if the PhoneNumberID is correct

• Confirm if the Token is correct

• Review the country code in ISO format

If needed:

• Search for the returned error

• Or send the full context of what you're trying to do + the error you got to chatGPT. It's important to say what you want to do, show how you did it and the error you got.
  We also have the community to help and you can, as a last resort, open a ticket with support if needed as well.