---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://yandex.ru/dev/direct/doc/en/objects/roles.md
  - https://yandex.ru/dev/direct/doc/ru/objects/roles.md
  - href: en/objects/roles.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
sourcePath: en/dg/objects/roles.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/direct/doc/en/llms.txt

# Roles and access of Yandex.Direct users

An advertiser's campaigns are managed by Yandex.Direct users.  The actions available to a user depend on the user's role.

<!--Здесь картинка-->

The table below shows the user roles and access for each type of client.

## Direct advertiser{#standalone}

A direct advertiser can have representatives with the following roles:

#|

|| **Role** | **Manage campaigns** | **Managing the advertiser's representatives** ||

|| Chief representative | Full access to manage the advertiser's campaigns. |
Full access to manage the advertiser's representatives: add, delete, restore, edit settings, and change the chief representative. Managing representatives is only available in the web interface (see [Registering representatives](https://yandex.com/support/direct/campaigns/representatives.html) in Yandex.Direct Help).

You can't change the access level for representatives who are registered in Yandex Balance.
||

||
Representative (full access) | Full access to manage the advertiser's campaigns, just like the chief representative. | Access to edit own settings. ||

|| Representative (read only) | They have access only to viewing campaign settings and statistics. | Access to edit own settings. ||

|#

## Agency{#agency}

An agency can have representatives with the following roles:

#|

|| **Role** | **Managing agency clients and their campaigns** | **Using agency representatives to manage accounts** ||

|| Chief representative | Full access to manage all the agency's clients and their campaigns. |
Full access to manage the agency's representatives: add, delete, restore, edit settings, assign representatives to work with clients, and change the chief representative. Managing representatives is only available in the web interface (see [Registering agency representatives](https://yandex.com/support/direct/campaigns/agency-representatives.html) in Yandex.Direct Help).

You can't change the access level for representatives who are registered in Yandex Balance.
||

|| Representative | Full access to manage all the agency's clients and their campaigns, just like the chief representative. | Access to edit settings for all the agency's representatives (except the chief representative). ||

|| Сlient representative |
Full access to manage only personal clients and their campaigns:

- Register new agency clients.

- Manage clients that were registered personally or that were assigned by the chief representative.
| Access to edit own settings. ||

|#

## Working with the API{#agency-api}

An agency can only work with the data of a single client in each request. Each request must pass the client username (preferably the chief representative) in the HTTP `Client-Login` header.

## Agency client advertiser{#subclient}

An agency can allow a client advertiser to access data:
- If the agency granted the advertiser read-only access to the web interface, the advertiser's representatives can only receive data via the API, as well.

- If the agency granted the advertiser permission to edit campaigns, the advertiser's representatives can use either the web interface or the API for managing their campaigns.

An agency client can have representatives with the following roles:


#|

|| **Role** | **Manage campaigns** | **Managing the advertiser's representatives** ||

|| Chief representative | Access to manage the advertiser's campaigns, within the permissions granted to the advertiser by the agency. |
Full access to manage the advertiser's representatives: add, delete, restore, edit settings, and change the chief representative (only if the agency gave the advertiser access to the web interface).

You can't change the access level for representatives who are registered in Yandex Balance.
||

|| Representative (full access) | Access to manage the advertiser's campaigns, within the permissions granted to the advertiser by the agency (just like the chief representative). |
Access to edit own settings (only if the agency gave the advertiser access to the web interface).
||

|| Representative (read only) | They have access only to viewing campaign settings and statistics. | Access to edit own settings. ||

|#

Thus, an agency client's campaigns can be managed either by agency representatives, or by representatives of the advertiser itself, if the agency provided appropriate access.

## Learn more

- [Client](https://yandex.ru/dev/direct/doc/en/objects/client.md)
- [Recommendations for registering representatives](https://yandex.ru/dev/direct/doc/en/objects/representatives-recommendations.md)