---
metadata:
  - name: generator
    content: Diplodoc Platform v5.44.0
alternate:
  - https://yandex.ru/dev/id/doc/en/register-auth.md
  - https://yandex.ru/dev/id/doc/ru/register-auth.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/id/doc/en/llms.txt

## App registration for authorization

### Step 1. Creating an app {#create}

1. Sign in to [Yandex OAuth](https://oauth.yandex.com/) with the Yandex account that you plan to use for app development.

   {% note warning %}

   To avoid losing access to your app, use an account you can always log in to. Make sure you can complete the verification process with this account.

   {% endnote %}

1. If your service isn't verified, please complete [verification](https://yandex.ru/dev/id/doc/en/confirm-account.md). Otherwise, your app's users will see a warning before granting it access to their data. This significantly reduces successful authorization conversions in your app.

   {% note tip %}

   Verification is especially important for this type of app.

   {% endnote %}

1. Create an app in one of the following ways:

      * Click **Create app**. In the pop-up window, select **For user authorization**.

      * Go to [https://oauth.yandex.ru/client/new/id/](https://oauth.yandex.ru/client/new/id/).

1. Specify app data:

   1. Fill in the **Your service's name** field and upload an icon.

      The file size can't exceed 1 MB.

      The user will see the service's name and icon on the authorization page and in the list of apps that have access to their account.

   1. Enter your **Contact email**. Make sure it's valid so you don't miss important product updates.

   1. Click **Continue**.

### Step 2. App platforms

1. Select the platforms you're setting up authorization for:

   * **Web services**
   * **iOS app**
   * **Android application**

2. Specify parameters of the platforms your app works on.

    {% list tabs %}

    - Web services

      **Redirect URI**. The URL the user is sent to after they give the app permission to access their data.

         For example, if you use the [instant authorization technology](https://yandex.ru/dev/id/doc/en/suggest-description.md) (recommended for web services), enter the URL of the callback page you'll create to receive the token.

         If you have an app ecosystem or use different environments, add extra **Redirect URIs**. You can select the appropriate address when you get the OAuth token.

         The **Redirect URI** specified in the OAuth app doesn't have to match the one in the request exactly. The following URL components must match:
         * Scheme
         * Host
         * Port (if any)
         * Path
         
         The following components may differ:
         * Query
         * Fragment

    - iOS app

      * **iOS AppId**. The exact ID of the iOS app, for example `A1B2C3D4E5.com.domain.application`. It consists of a Prefix and a Bundle ID. Learn more about iOS app IDs in the [Apple documentation](https://www.google.com/url?q=https://developer.apple.com/library/content/documentation/General/Conceptual/DevPedia-CocoaCore/AppID.html&sa=D&source=docs&ust=1747637795082304&usg=AOvVaw1WD8iSfwTtgbDQDFbb-5WT).

      * **iOS AppStore URL**. Link to the app in the AppStore.

    - Android application

      * **Android package name**. The app package name (the `applicationId` field in the `build.gradle` file of your module). Read more about Android app IDs in [Android documentation](https://developer.android.com/studio/build/application-id.html).

      * **Android Google Play URL**. Link to the app in Google Play.

      * **SHA256 Fingerprints**. The certificate fingerprint of your app. Learn more about generating a fingerprint in the [Android documentation](https://developers.google.com/android/guides/client-auth#using_gradles_signing_report).

    {% endlist %}

   {% note info %}

   If you're developing an app for iOS or Android, use [SDK Yandex ID](https://yandex.ru/dev/id/doc/en/mobileauthsdk/about.md) to get an OAuth token.

   {% endnote %}

### Step 3. Data access

1. Select the user data your app needs to access. Apps typically request access to the following:

   * Login, first name, last name, and gender.
   * User's profile picture.
   * Email address.
   * Phone number.
   * Date of birth.

   You can select any other permissions as needed.

   The user will see the list of requested data on the authorization page and in the list of apps that have access to their account.

   {% note tip %}

   Select only the data that your app will actually use.

   {% endnote %}

1. Click **Continue**.

### Completing registration {#finish}

After setting up all the app's parameters, a window will appear in Yandex OAuth that users will see when logging in to your app via Yandex ID To confirm saving, click **Everything is correct**.

Further steps to connect to the API Yandex ID include:

* Getting an [OAuth token](https://yandex.ru/dev/id/doc/en/access.md).
* Entering [user information](https://yandex.ru/dev/id/doc/en/user-information.md).

To configure this, use the parameters listed on the app's page in your Yandex OAuth account.