Eloqua Product Notice: OAuth token endpoint – More detailed 401 response (Aug 2021)
With the arrival of Eloqua release 21C (Aug 2021), the OAuth token endpoint, https://login.eloqua.com/auth/oauth2/token, will return a more detailed 401 response.
Currently, when the OAuth token endpoint returns a “401 Unauthorized” error there is little detail provided.
With 21C, with a status of “401 Unauthorized” the response body will now include the following:
The error is the name of the error type, the error_code is the numeric value uniquely identifying the type of error, and the error_description provides details on the error.
Errors have been divided into categories indicated by the 1000s digit of the error_code according to the following (Additional categories will be added as needed):
- General Error Messages - 1000
- Error Messages Related to Authentication - 2000
- Error Messages Related to OAuth2 Authentication - 2500
- Error Messages Related to Authorization - 3000
The following error, error_code, and error_description sets are included in this change:
Example – More Detailed 401 Response
"error_description": "Provided Token is Unknown."
With the arrival of Eloqua release 21C (Aug 2021), the OAuth token endpoint, https://login.eloqua.com/auth/oauth2/token, will return a more detailed error response. Check the Eloqua Release Center for specific dates and times.
If using the OAuth token endpoint, prepare for the new more detailed 401 response.
View changes for Eloqua's APIs including, new features, significant recent changes, and platform notices, on the Eloqua Developer Changelog.
If you have questions, reply to this post!
Q: What endpoints are impacted by this change?
A: Only the OAuth token refresh endpoint, https://login.eloqua.com/auth/oauth2/token, is impacted.
Group Product Manager, CX - Marketing: Eloqua