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

# For agencies

In Yandex Direct, advertisers are hierarchically subordinate to the agency that they are clients of. Agency representatives can manage agency clients and their advertising campaigns.  An agency can be used as a manager account for accessing multiple client accounts (like an MCC).

#### Learn more

- [Client](https://yandex.com/dev/direct/doc/en/objects/client.md)
- [Roles and access of Yandex Direct users](https://yandex.com/dev/direct/doc/en/objects/roles.md)

## Managing clients' advertising campaigns {#client-login}

An agency can manage the data of its advertiser clients (such as campaigns or ads) by sending requests to Yandex Direct API services on behalf of the agency representative. To do this:

- In the `Authorization` header, specify the access token you received for the agency representative.

- In the `Client-Login` header, specify the username of the representative of the client advertiser.

For example:

```text translate=no
Authorization: Bearer 0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f
Client-Login: agrom
```

An agency can only work with the data of a single advertiser in each request. If you need to obtain or change data for multiple advertisers, you must make a separate request for each advertiser.

Exceptions:

- In requests to the [AgencyClients](https://yandex.com/dev/direct/doc/agencyclients/agencyclients.html) service, don't specify the `Client-Login` HTTP header.

- When calling the [Clients.get](https://yandex.com/dev/direct/doc/clients/get.html) method. You can omit the `Client-Login` header, specify the username of an agency representative, or specify the username of an advertiser representative.

- When calling [Dictionaries.get](https://yandex.com/dev/direct/doc/dictionaries/get.html), [Changes.checkDictionaries](https://yandex.com/dev/direct/doc/changes/checkDictionaries.html), [KeywordsResearch.deduplicate](https://yandex.com/dev/direct/doc/keywordsresearch/deduplicate.html) and [KeywordsResearch.hasSearchVolume](https://yandex.com/dev/direct/doc/keywordsresearch/hasSearchVolume.html), the `Client-Login` header is optional.

#### Learn more

- [HTTP headers](https://yandex.com/dev/direct/doc/en/concepts/headers.md)
- [Access tokens](https://yandex.com/dev/direct/doc/en/concepts/auth-token.md)

## Managing clients {#agencyclients}

Requests to the [AgencyClients](https://yandex.com/dev/direct/doc/agencyclients/agencyclients.html) service must be made on behalf of the agency representative.

An agency representative can:

- Get a list of advertisers that are an agency's clients, their parameters, and settings for each advertiser's chief representative using the [AgencyClients.get](https://yandex.com/dev/direct/doc/agencyclients/get.html) method.

- Register new advertisers (agency clients) using the [AgencyClients.addPassportOrganization](https://yandex.com/dev/direct/doc/agencyclients/addPassportOrganization.html) method. Access to this method is provided [on request](https://yandex.com/dev/direct/doc/troubleshooting/add-client.html), and only for agencies that have a large number of active clients and need to regularly register new accounts in bulk.

- Change the parameters of advertisers (agency clients) and the settings of their chief representatives using the [AgencyClients.update](https://yandex.com/dev/direct/doc/agencyclients/update.html) method.

## Getting agency parameters and representative settings {#own}

Using the [Clients.get](https://yandex.com/dev/direct/doc/clients/get.html) method:

- Any agency representative can also get the agency parameters and their own personal settings.

- The agency's chief representative can also get and edit the settings of another representative (in addition to their own settings). To do this, pass the representative's username in the `Client-Login` request header.

## Agency points {#points}

"Points" belong to both the advertiser and the agency. By default, making API requests in the name of an agency representative spends the points of the agency's client advertiser (if the `Client-Login` header is specified). To use the agency's points, you need to set up the HTTP header

```text translate=no
Use-Operator-Units: true
```

The agency makes its own decision on when to spend its own points, and when to spend a client's points. For example, an agency can use its points to:

- Create advertising campaigns and ads for a new client who hasn't accumulated enough points yet.

- Manage campaigns for an active client who has run out of points.

#### Learn more

- [Restrictions, points](https://yandex.com/dev/direct/doc/en/concepts/units.md)