---
metadata:
  - name: generator
    content: Diplodoc Platform v5.19.4
alternate:
  - https://yandex.ru/dev/audience/en/intro/authorization.md
  - https://yandex.ru/dev/audience/ru/intro/authorization.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/audience/en/llms.txt

# Authorization

In order to use the Yandex Audience API, you need to get an [access token](https://yandex.com/dev/oauth/doc/dg/concepts/ya-oauth-intro.html) from the Yandex OAuth service. You must pass the token in the HTTP `Authorization` header for each method.

Example in the HTTP header:

```httpget translate=no
GET /v1/management/segments HTTP/1.1
Host: https://api-audience.yandex.com
Authorization: OAuth 05dd3dd84ff948fdae2bc4fb91f13e22bb1f289ceef0037
Content-Type: application/json
Content-Length: 123
```

## Getting an OAuth token {#get-oauth-token}

To get an OAuth access token, [register your application](https://oauth.yandex.com/client/new). On the registration page, select these permissions:
- Create segments, change the setting parameters of both your segments and delegated segments
- Read setting parameters of both your segments and delegated segments

For more information about authorization, read the document [OAuth authorization. Developer's guide](https://yandex.com/dev/oauth/doc/dg/concepts/about.html). This guide contains recommendations for client application developers.

To find out how to get a debugging token for application development, see the section [Debugging token](https://yandex.com/dev/oauth/doc/dg/tasks/get-oauth-token.html).