Skip to main content
menu_icon.png

Everything you need to learn Optimizely X in one place: See our resource pages for Web Experimentation and Personalization.

x
Optimizely Knowledge Base

Generate a personal access token in Optimizely X Web

This article is about Optimizely X. If you're using Optimizely Classic, check this article out instead.
 
 
relevant products:
  • Optimizely X Web Experimentation
  • Optimizely X Web Personalization
  • Optimizely X Web Recommendations

THIS ARTICLE WILL HELP YOU:
  • Generate a personal access token for yourself or another user in Optimizely

Optimizely's REST API lets you create and manage Optimizely projects and experiments -- and analyze results -- from other applications. For example, our solutions partners and technology partners use the REST API to:

  • Create Optimizely audiences based on information collected from your Data Management Platform

  • Manage Optimizely projects from an internal system

  • Pull results data into an internal dashboard or results widget

  • Send email alerts when certain results are achieved

To use the Optimizely REST API, you'll need to authenticate by generating an API token.

Administrators can generate and revoke personal tokens for all other users in their account. Here are a few more details about personal tokens, by Optimizely collaborator role

Administrators

  • Generate personal tokens for any collaborator in the Optimizely account they administer

  • Revoke personal tokens generated for any collaborators in their account, at any time

  • View a list of all active tokens in an account

Editors, Project Owners, and Viewers

  • Generate generate personal tokens for themselves

  • Revoke their own personal tokens, at any time

  • View the active tokens that they've generated for themselves

This article shows you how to generate or delete a token in Optimizely X. You can also learn more about token-based authentication in Optimizely X in our developer documentation.

For a​​​​pplications built on the REST API (such as technology integrations), you can alternatively use OAuth to access Optimizely data.

Generate a token

Here's how to generate a personal token in Optimizely X:

  1. Navigate to Profile > API Access.

  2. Click Generate New Token.

  3. Enter a token name and click Create.



    If you're an administrator, you can create tokens for other collaborators on the account. Use the dropdown menu to select a collaborator. If you're not an administrator for the account, you can only generate a personal token for yourself.

  4. Copy the token.

For security purposes, once you navigate away from the API Access tab, the token will no longer be visible when you return. If you need a token, please generate a new one.

Remember to keep your tokens secret; treat them like passwords! If you need a new one, revoke or delete the token and generate another.

Delete a token

Deleting a token permanently removes it, so you can no longer use it to connect to the Optimizely API. If you're an administrator, you can delete any personal token attached to the account. If you're not an administrator for the account, you can only delete the tokens that you generate for yourself.

Here's how to delete a token:

  1. Navigate to Profile > API Access.

  2. Under Personal Access Tokens, click Delete.

  3. Click Delete Token to confirm. You cannot undo this action.