List of Authorization Errors

If an error occurs, the API will notify you using one of the following methods:

If the error occurs during the Authorization flow, you’ll receive a 302 redirect.
If the error occurs while you’re using the Token or Revoke Connection endpoints, you’ll receive a JSON response.

The JSON error response will be in on of the following formats:

Json

{
  "error": "error",
  "error_description": "error_description"
}

Http

    https://www.example.com/callback?
    error=error
    &error_description=error_description
    &state=state

Supported errors

We recommend that you set up your configuration to expect and handle the following errors.

ERROR	STATUS CODE
access_denied	400
invalid_request	400
invalid_client	400
invalid_grant	400
invalid_scope	400
unauthorized_client	400
unsupported_grant_type	400
unsupported_response_type	400
unsupported_token_type	400
server_error	500
temporarily_unavailable	503

Common Error Scenarios

Common error scenarios include consent errors and non transient failures This type of error is caused by an issue with the end users consent. If the end user denies consent during authorization, you’ll receive a 302 redirect with an error, error_description, and the original state.

Non Transient Failures

This type of error is caused by a specific issue that must be addressed. You will continue to see this error until the error is corrected.

SCENERIO	ERROR	STATUS CODE	ACTION
Invalid client or client credentials	invalid_client	400	Confirm the `client_id` and `client_secret` are correct.
Authorization header is not included	invalid_scope or invalid_request	400	Include the authorization header in the request.
Refresh token is expired or invalid	invalid_grant	400	A new `refresh_token` is generated each time a user logs in, making all previous tokens unusable. Discard the `refresh_token` after each use to avoid receiving this error.

API Reference

Auth

Connect

Enrich

Outbound

Pay

Upload

Utilities

Supported errors

Common Error Scenarios

Non Transient Failures

​Supported errors

​Common Error Scenarios

​Consent Errors

​Non Transient Failures

Supported errors

Common Error Scenarios

Consent Errors

Non Transient Failures