---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.2
alternate:
  - https://yandex.com/dev/direct/doc/dg-v4/en/concepts/register.md
  - https://yandex.com/dev/direct/doc/dg-v4/ru/concepts/register.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/direct/doc/dg-v4/en/llms.txt

# App registration

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

1. [Registration on the OAuth server](#oauth)
1. [Creating a request for API access](#request)


## Registration on the OAuth server {#oauth}

1. Log in on Yandex with the app developer's username.
1. Go to [https://oauth.yandex.com/client/new](https://oauth.yandex.com/client/new).
1. In the registration form, enter the app parameters and click the **Create** button.
    App parameters are covered in the section [Registering an application](https://tech.yandex.com/oauth/doc/dg/tasks/register-client-docpage/) in the OAuth guide. In the **Permissions** option, select the value **Access to Yandex Direct API**. You can change the app parameters later.
    

As a result of registration, the Yandex OAuth server will generate and display the ID and app password on the page. The app ID must be specified when creating a [request for API access](#request). The app ID and password are necessary for getting an [access token](https://yandex.com/dev/direct/doc/dg-v4/en/concepts/auth-token.md) that allows the app to access the data of a specific user.

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


## Creating a request for API access {#request}

1. Log in on Yandex with the app developer's username.
1. Go to the [My requests](https://direct.yandex.com/registered/main.pl?cmd=apiCertificationRequestList) page on the **API settings** page.
    
    {% note alert %}
    
    To get access to the API settings page, you must create at least one [advertising campaign](https://direct.yandex.com/registered/main.pl?cmd=editCamp&new_camp=1&mediaType=text&) in the Yandex Direct web interface (creating a single draft ad with one keyword is enough).
    
    The first time you open the API settings page, you must accept the user agreement.
    
    {% endnote %}
    
1. 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](https://direct.yandex.com/registered/main.pl?cmd=apiSandboxSettings).
    - “Test access” — Request for limited access to the Yandex Direct API that **only** includes access to the [Sandbox](https://direct.yandex.com/registered/main.pl?cmd=apiSandboxSettings), which is sufficient for developing and debugging an app. Later, a request for limited access can be changed to a request for full access.
    
1. On the request creation form:
    - Select the app ID that was obtained during [registration on the OAuth server](#oauth).
    - 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 request is reviewed for up to 7 days. When a request has been reviewed, it gets the status “approved” or “rejected”.

A list of app registration requests you have created is available on the [My requests](https://direct.yandex.com/registered/main.pl?cmd=apiCertificationRequestList) 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 {#modify}


{% note alert %}

You must make sure the information entered in the API access request is correct and current. If the data changed (for example, the app developer's email address has changed, or the numer of copies of the app in use has grown significantly), edit the request.

{% endnote %}


You can edit a request from the [My requests](https://direct.yandex.com/registered/main.pl?cmd=apiCertificationRequestList) 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.