---
metadata:
  - name: generator
    content: Diplodoc Platform v5.54.1
alternate:
  - https://yandex.ru/dev/ytm/ru/intro/authorization.md
  - href: ru/intro/authorization.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/ytm/ru/llms.txt

# Авторизация

Для использования API Яндекс Тег Менеджера необходимо получить [авторизационный токен](https://yandex.ru/dev/id/doc/ru/) через OAuth-сервер Яндекса. Токен необходимо передавать для каждого метода в HTTP-заголовке `Authorization`.

Пример запроса:

```
GET /ytm/management/v1/container/{containerId}/tags HTTP/1.1
Host: https://api.ytm.yandex.net
Authorization: OAuth <access_token>
Content-Type: application/json
Content-Length: 127
```

Если метод API вызван без токена или в запросе передан недействительный токен, сервер возвращает HTTP-статус `401 Unauthorized`.

{% note info %}

Обеспечьте безопасное хранение авторизационного токена, не передавайте его третьим лицам.

{% endnote %}

## Получение OAuth-токена {#getting-OAuth-token}

Чтобы получить авторизационный токен:

1. [Создайте приложение](https://oauth.yandex.ru/client/new), при этом заполните поля:

   - **название** — можно указать произвольно;
   
   - **иконка сервиса** — необязательно;
   
   - **платформы приложения** — выберите веб-сервисы;
   
   - **redirect URI** — укажите `https://oauth.yandex.ru/verification_code`;
   
   - **доступ к данным** — укажите **ytm:read**.

2. Нажмите **Создать приложение** и скопируйте его ClientID (напротив идентификатора нажмите значок ![](../_assets/copy.png)).

3. Добавьте скопированный ClientID в ссылку вида

   `https://oauth.yandex.ru/authorize?response_type=token&client_id=<идентификатор приложения>`

4. Перейдите по ссылке и на открывшейся странице скопируйте ваш авторизационный токен.