Guide | Error "Token Authentication Required"

Last updated: March 31, 2026

This error can occasionally appear while testing the Web SDK in the Astra sandbox (and while rare, can also occur in production).

If you encounter this error please review the following recommendations which should resolve the issue:

Astra_TokenAuthenticationRequiredNotification.png
  1. Verify phone number association – Confirm that the phone number value specified in the Web SDK URL is also associated with the user_intent_id, business_profile_id or user_id.

    1. user_intent_id.phone (User Intent object) = phone value specified in the SDK query parameters

    2. business_profile_id.phone (Business Profile object) = phone value specified in the SDK query parameters

    3. user_id.phone (User object) = phone value specified in the SDK query parameters

  2. Use a fresh browser session – Once you've generated the Web SDK URL, open a new browser tab and clear your cache before pasting it in.

    1. For sequential testing with different phone numbers, its best to always open the Web SDK URL in a new browser window/tab.

  3. Format the phone number to specifications – The phone number in the Web SDK URL needs to be in the 10 digit format. Remove the plus sign and country code.

    1. Example:

      1. +12035528474

      2. 2035528474