Adds or updates an OAuth access_token for a user outside the usual login flow.

When a user logs in with an OAuth Identity Provider, Akamai requests an OAuth token from the provider. This OAuth token is used in making subsequent API calls to the provider. The add_or_update_access_token call adds a token retrieved using a non-Identity Cloud method.

Possible use cases for this endpoint include the following:

  • If you are migrating an existing application to Social Login or have otherwise acquired an OAuth token for a user outside of Akamai, you can use that token to make  RESTful API calls for that user.
  • If data is needed for a user that has not registered using Social Login. The user's ID and access token are recorded, making it possible to use the get_user_data endpoint.

Only these identity providers support this call:

  • Facebook
  • Foursquare

This endpoint includes the following methods:

  • POST


Accepted Content-types

  • application/x-www-form-urlencoded
  • multipart/form-data

Example Request

This command provides an alternate method for obtaining or refreshing an access token.

curl -X POST \
  --data-urlencode apiKey=1234567891234567891234567891234567891234 \
  --data-urlencode token=123456789123456789 \
  --data-urlencode identifier=http://www.facebook.com/profile.php?id=123456789123456789123 \
      Running this command in Postman

Example Response

  "stat": "ok"


This endpoint uses your social login API key for authentication. This key can be found on the Settings page of the Social Login Dashboard.

Base URL

The base URL for this endpoint is your application domain followed by /api/v2; for example:


You can find your application domain in the Social Login (Engage Dashboard) on the Settings page:

Query Parameters

Parameter Type Required Description
apiKey string Yes Social Login API key. This key can be found on the Social Login Dashboard.
identifier string Yes Identifier associated with the social login identity provider. This value must be formatted as part of a URL; for example
token string Yes Access token for the user. Tokens must be requested from identity providers based on their API requirements.