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

Error when registering number

Displayed message: "For API Version 21 and above, please first call settings endpoint"

Image #1 – Error example

This error happens in newer versions of the WhatsApp Cloud API (v21+), when the required settings endpoint hasn’t been called yet for the number before the 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 through the browser:

1. Open the panel where the connection problem is happening

2. Press F12

3. Go to the Network tab

4. Redo 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 standard: ISO 3166-1 alpha-2

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 the POST method with the URL:

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

Replace:

• _phoneNumberID_ → with the phoneNumberID from 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": "CountryCode_In_ISO_3166_1_alpha_2_code" } }

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

Expected result

After clicking SEND in ReqBin:

If it shows up in green: 200 (OK)

This means that:

• The configuration was applied correctly

• The number can already be connected again

Now you just need to repeat the connection process in the CRM.

If it gives an error

If it returns a different error:

• Check if the PhoneNumberID is correct

• Confirm if the Token is correct

• Review the country code in ISO format

If needed:

• Research 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, send 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.