Templated Tokens

Templated tokens let third-party integrations provide users with a URL that opens the Personal Access Token or OAuth Application creation form with pre-filled values. This simplifies onboarding for integrations that need specific API permissions — users only need to click a link and confirm.

URL Format

Templated token URLs use the standard Xurrent UI base URL (https://<account>.<region.><domain>) with the following paths:

Personal Access Tokens:

/personal_access_tokens/new?name=<name>&scopes=<scopes>

OAuth Applications:

/oauth_applications/new?name=<name>&scopes=<scopes>&grant_type=<grant_type>

Parameters

name
Required string - Name of the token or application (max 128 characters, URL-encoded).
scopes
Required string - Comma-separated list of scopes in model:action format. See Scope Format below.
grant_type
OAuth apps only string - Must be client_credentials or authorization_code.

Scope Format

Scopes follow the model:action pattern. Actions can be specified in several ways:

Multiple scopes are separated by commas: request:RU,problem:RU

Examples

Personal Access Token

Read service instances (CRUD shorthand)

Full access to request templates (wildcard)

Multiple scopes (read/update requests + read/update problems)

OAuth Application

Client credentials grant

Authorization code grant