Forum Stats

  • 3,678,607 Users
  • 7,142 Discussions
  • 12,099 Comments

Discussions

Eloqua Product Notice: OAuth token endpoint – More detailed 401 response (Aug 2021)

JodyMooney-Oracle
JodyMooney-Oracle Group PM, CX Marketing - EloquaPosts: 305 Employee

Overview

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.

 

What’s changing?

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:

  • error
  • error_code
  • error_description


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

401 Unauthorized

{

   "error": "unknown_token",

   "error_code": 2501,

   "error_description": "Provided Token is Unknown."

}

 

Timeline

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.

 

Next Steps

If using the OAuth token endpoint, prepare for the new more detailed 401 response.

 

Additional Resources

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!

 

FAQ

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