Skip to main content
Only a tenant security administrator can create OAuth 2.0 clients. A Device grant client is a SEPARATE registration from an Authorization code grant client - the same Client ID cannot serve both. Device grant is disabled when single sign-on (SSO) is enabled.

Create a Device grant OAuth client

Sign in to Anaplan as a tenant security administrator.

  • Select Administration from the top-left navigation menu.
  • Select Security > OAuth Clients, and select Enable OAuth if this is the first time.
  • Select New, enter a Name, and select Device grant from the Type dropdown.
  • Allowed callback URLs is required by the form but unused for a device client - enter any valid URL, for example https://anaplan.com.
  • Set the refresh token behaviour. Non-Rotatable tokens never expire, so the connection never needs re-authorising - this is the recommended setting for StackOne. Rotatable tokens expire after the maximum lifetime you set (43,000 seconds by default), after which the account must be re-linked by hand.
  • Select Create client and copy the Client ID.

Complete the device authorisation once

Run these two calls yourself to turn the Client ID into a refresh token. Replace the host with the OAuth service URL for your region (see the field description below).

1

Request a device code

  • The response carries a device_code and a verification URL.
  • Open the verification URL in a browser (incognito is recommended) and sign in to approve the device.
2

Exchange the device code for a refresh token

  • Copy the refresh_token from the response into the Refresh Token field below.
  • The access_token in the same response is not needed - the connector requests its own and renews it every 35 minutes.
1

Connect

  • Click Connect.
  • If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider’s authorization flow.
  • Once authorization is successful, you will see a confirmation popup.
2

Use Actions

Connect an AI platform to the linked account’s actions. See AI Platforms.Other ways to call actions are listed in Protocols & SDKs.