Migrating from Optimizely Classic

If you have any questions about migrating to Optimizely X, you can submit a ticket to the developer support team. We'll be happy to assist you.

We're excited to release the v2 REST API, providing read-and-write access to your Optimizely X data and read-only access to your Classic Optimizely data. This version of our REST API has been completely re-built from the ground up. This API has been written to support the new data models in Optimizely X causing the endpoints to vary from v1. We have also incorporated many new features requested by developers like pagination, enhanced error handling and improved input validation. This guide will walk you through the key differences between versions.

First, we've added the Campaign model, which is a collection of Experiments that share the same objective. Campaigns should now be leveraged when creating a personalization campaign that shares the same focus. With this addition, Projects will now consist of Experiments and/or Campaigns.

In v2, variations are a property of experiments. Variations cannot be queried outside of the experiment context, so there is no /variations endpoint like there was in the v1 API. We have also introduced the concept of a Page which controls where experiments can run. Previously, this was defined in url_conditions in an experiment.

The notion of Goals has transformed into Metrics and Events. Events most closely resemble goals, as they are specific actions you can track. For example, an Event could be button clicks within a page, or page views. Metrics define how to add up the data we receive from Events. Audiences remain the same between versions.

In the v1 API it was possible to authenticate with tokens that you could generate on http://app.optimizely.com/tokens. Those "Classic Tokens" are replaced by "Personal Tokens" in the v2 API.

Migration Checklist

If you have any questions, you can submit a ticket to the developer support team. We'll be happy to assist you.

Mapping v1 to v2

Optimizely X

Optimizely Classic






New in Optimizely X

The field variations on Experiments



New in Optimizely X. Previously lived in edit_url and urls_condtions in the Experiment object.

Events, metrics




Experiment Results

Experiment Results

Campaign Results

New in Optimizely X




Read more about migrating from classic

Did this page help you?