App registration

The registration procedure is completed by the app developer and includes two stages:

1. Registering your app with Yandex ID
2. Creating a request for API access

Registering your app with Yandex ID

1. Log in on Yandex with the app developer's username.
2. Go to https://oauth.yandex.ru/client/new.
3. In the registration form, enter the app parameters and click the Create button.
   For more information about app parameters, see the App registration section of the Yandex ID documentation. In the Access to user data field, enter Access to Yandex.Direct API or direct:api and select the found value. You can change the app parameters later.

After you register, Yandex ID generates the app ID and password and displays them on the page. The app ID must be specified when creating a request for API access. The app ID and password are necessary for getting an access token that allows the app to access the data of a specific user.

Your list of registered apps is available at https://oauth.yandex.ru/. You can find out an app's ID and password, change app parameters, or remove an app.

Creating a request for API access

1. Log in on Yandex with the app developer's username.

2. Go to the My requests page on the API settings page.

   Alert

   To get access to the API settings page, you must create at least one advertising campaign in the Yandex Direct web interface.

   The first time you open the API settings page, you must accept the user agreement.

3. Click the New request button. In the menu that opens, select the type of request:

   • “Full access” — Request for full access to the Yandex Direct API, including the ability to manage clients' real advertising campaigns and access to the Sandbox.
   • “Test access” — Request for limited access to the Yandex Direct API that only includes access to the Sandbox, which is sufficient for developing and debugging an app. Later, a request for limited access can be changed to a request for full access.

4. On the request creation form:

   • Select the ID assigned to your app during registration in Yandex ID.
   • Enter a valid email address that you currently use.
   • In the other fields, provide the most accurate and complete information about the app as possible.
   • Confirm your compliance with the user agreement.

   Click the Send button.

The review process takes up to 7 days. Following the review, your request will either be approved or rejected.

A list of app registration requests you have created is available on the My requests tab on the API Settings page. You can track the status of requests being processed, and if a request is declined, you can find out the reasons for rejection, edit and delete requests, and also change a request for limited access to a request for full access.

Changing a request for API access

You can edit a request from the My requests tab on the API Settings page. After making changes to a request, it will be re-sent for processing. The parameters from the previous request will be effective until the new version of the request is approved.