Step 2: Handling OAuth Error Cases

If the customer does not authenticate or authorize the app, Yext will redirect the customer back to the app with error and error description parameters:

Unsuccessful authentication/authorization redirect URL

// If your URI does not contain query parameters, appended with ?
<REDIRECT_URI>?error=<ERROR>&error_description=<ERROR_DESCRIPTION>state=<STATE>
 
// If your URI contains query parameters, appended with &
<REDIRECT_URI>&error=<ERROR>&error_description=<ERROR_DESCRIPTION>state=<STATE>

The following errors can be returned:

  • access_denied
    • The customer did not authorize the App to access the requested endpoints with the requested permissions.
  • unsupported_response_type
    • The specified response type is unsupported. Our OAuth only supports the code response type.