Get OAuth2 Tokens

Last update: November 7, 2023

Topics:
Workfront API

CREATED FOR:

Developer

Getting OAuth2 Tokens

Returns the OAuth2 refresh token and access token for an authenticated user. This is invoked once when the the user provisions a Document Provider. Subsequent calls are made to get an updated access token.

URL

POST /any/url

The URL is configurable and corresponds to the Token Endpoint URL value on the custom integration Setup page.

Query Parameters

Name	Required	Description
grant_type	yes	Values include "authorization_code" or "refresh_token". The value specified indicates which of the two parameters will be passed to this API call: code or refresh_token.
code	depends	The authorization code sent to Adobe Workfront just after the user clicks the "Grant" button. This is only required when the grant type is "authorization_code". The authorization code should be short lived, generally expiring in 10 minutes or less.
refresh_token	depends	This is only required when making subsequent calls to retrieve a new access_token, given that the previous access_token as expired. When sending this value set the grant_type parameter to "refresh_token".
client_id	yes	The Client ID configured in Workfront for this custom integration.
client_secret	yes	The Client Secret configured in Workfront for this custom integration.

Response

Name	Type	Description
access_token	String	A token used to make authorized API calls on the user's behalf. This should expire to prevent unauthorized API calls.
refresh_token	String	A long-lived token used to retrieve a new access_token by calling this API method.
expires_in	long	(optional) The time (in seconds) before the access_token expires, generally 3,600.

Example

POST /oauth2/token
grant_type=authorization_code
code=d9ac7asdf6asdf579d7a8
client_id=123456
client_secret=6asdf7a7a9a4af

Response

{
access_token:"ad8af5ad5ads759",
refresh_token:"9a0h5d87d808ads",
expires_id:3600
}

recommendation-more-help