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


# addPassportOrganization

Создает бизнес-аккаунт организации.

{% note info %}

В запросе к сервису `AgencyClients`:

- В HTTP-заголовке `Authorization` укажите токен, полученный для представителя агентства.
- В HTTP-заголовке `Member-Authorization` укажите токен для логина, который должен быть добавлен в бизнес-аккаунт в качестве участника

{% endnote %}

**Узнайте больше**

- [Как работает метод add](https://yandex.ru/dev/direct/doc/dg/best-practice/modify.html)
- [Как обрабатывать ошибки](https://yandex.ru/dev/direct/doc/dg/concepts/errors.html)

## Запрос {#input}

Структура запроса в формате JSON:

```json translate=no
{
  "method": "addPassportOrganization",
  "params": {
      "Name": (string),
      "Currency": ("RUB"|"BYN"|"CHF"|"EUR"|"KZT"|"TRY"|"UAH"|"USD"),
      "Grants": [{
        "Privilege": ("EDIT_CAMPAIGNS"|"IMPORT_XLS"|"TRANSFER_MONEY"),
        "Value": ("YES"|"NO")
      }, ... ],
      "Notification":
        "Lang": ("RU"|"UK"|"EN"|"TR"),
        "Email": (string),
        "EmailSubscriptions": [{
          "Option": ("RECEIVE_RECOMMENDATIONS"|"TRACK_MANAGED_CAMPAIGNS"|"TRACK_POSITION_CHANGES"),
          "Value": ("YES"|"NO")
        }, ... ],
      "Settings": [{
        "Option": ("CORRECT_TYPOS_AUTOMATICALLY"|"DISPLAY_STORE_RATING"),
        "Value": ("YES"|"NO")
      }, ... ],
      "TinInfo": {
        "TinType": ("PHYSICAL"|"FOREIGN_PHYSICAL"|"LEGAL"|"FOREIGN_LEGAL"|"INDIVIDUAL" ),
        "Tin": (string)
      }
  }
}
```

#|
||

**Параметр**

|

**Тип**

|

**Описание**

|

**Обязательный**

||
||

**Структура params (для JSON) / AddPassportOrganizationRequest (для SOAP)**
|
>
|
>

||
||

`Name`

|

string

|

Название организации в Яндекс ID, которая будет выступать в качестве главного представителя рекламодателя. В кабинете Директа будет отображаться автоматически сгенерированный логин организации в Яндекс ID.

Для указанного названия в Яндекс ID создается новая организация, которая привязывается к бизнес-группе агентства. [Подробнее про организации](https://yandex.ru/support/id/ru/organizations-manage).

- В созданную организацию в Яндекс ID добавляется _Главный представитель_ агентства с ролью _Владелец_.  

- Пользователь, чей токен передан в заголовке `Authorization`, будет добавлен в организацию в Яндекс ID с ролью _Администратор_. 

- Пользователь, чей токен передан в заголовке `Member-Authorization` будет добавлен в организацию в Яндекс ID с ролью Участник. 

[Подробнее про ролевую модель сотрудников организации в Яндекс ID](https://yandex.ru/support/id/ru/organizations-workers)

Название должно содержать не более 30 символов. Не допускаются символы  `[`,  `,`, `]`, `&`, `=`, `<`, `>`.

|

Да

||
||

`Currency`

|

CurrencyEnum

|

Валюта рекламодателя.

|

Да

||
||

`Grants`

|

array of GrantItem

|

Полномочия рекламодателя по управлению кампаниями. Если не заданы — полномочия отсутствуют.

|

Нет

||
||

`Notification`

|

NotificationAdd

|

Настройки email-уведомлений для главного представителя рекламодателя.

|

Да

||
||

`Settings`

|

array of ClientSettingAddItem

|

Настройки рекламодателя, допускаются только значения YES или NO.

|

Нет

||
||

`TinInfo`

|

TinInfoAdd

|

Налоговые данные конечного рекламодателя.

|

Да

||
||

**Структура GrantItem**
|
>
|
>

||
||

`Privilege`

|

PrivilegeEnum

|

Название полномочия:

* EDIT_CAMPAIGNS — редактирование кампаний.

* IMPORT_XLS — управление кампаниями с помощью файлов (см. раздел [Управление кампаниями с помощью файлов формата XLS и XLSX](https://yandex.ru/support/direct/alternative-interfaces/xls-interface.html)  Справки Директа).

Если полномочие не указано, оно будет создано со значением NO.

Для полномочия IMPORT_XLS можно указать значение YES только при условии, что для полномочия EDIT_CAMPAIGNS также указано значение YES, в противном случае возвращается ошибка.

|

Да

||
||

`Value`

|

YesNoEnum

|

Есть ли у рекламодателя данное полномочие.

|

Да

||
||

**Структура NotificationAdd**
|
>
|
>

||
||

`Lang`

|

LangEnum

|

Язык уведомлений.

|

Да

||
||

`Email`

|

string

|

Адрес электронной почты для отправки уведомлений, связанных с аккаунтом.

|

Да

||
||

`EmailSubscriptions`

|

array of EmailSubscriptionItem

|

Типы уведомлений, отправляемых по электронной почте.

|

Да

||
||

**Структура EmailSubscriptionItem**
|
>
|
>

||
||

`Option`

|

EmailSubscriptionEnum

|

Тип уведомления:

* RECEIVE_RECOMMENDATIONS — новости Директа и рекомендации.

* TRACK_MANAGED_CAMPAIGNS — уведомления по кампаниям, обслуживаемым персональным менеджером.

* TRACK_POSITION_CHANGES — предупреждения о снижении прогноза трафика относительно того, который обеспечивали ставки на момент установки.

Если тип уведомления не указан, он будет создан со значением NO.

|

Да

||
||

`Value`

|

YesNoEnum

|

Отправлять ли уведомления данного типа.

|

Да

||
||

**Структура ClientSettingAddItem**
|
>
|
>

||
||

`Option`

|

ClientSettingAddEnum

|

Имя настройки:

* CORRECT_TYPOS_AUTOMATICALLY — автоматически исправлять ошибки и опечатки.

* DISPLAY_STORE_RATING — дополнять объявления данными из внешних источников (см. раздел [Данные из внешних источников](https://yandex.ru/support/direct/efficiency/enrich-ads-with-third-party-data.html) Справки Директа).

Если настройка не указана, она будет создана со значением NO.

|

Да

||
||

`Value`

|

YesNoEnum

|

Значение настройки.

|

Да

||
||

**Структура TinInfoAdd**
|
>
|
>

||
||

`TinType`

|

TinTypeEnum

|

Тип организации:

* LEGAL — юридическое лицо;

* PHYSICAL — физическое лицо;

* INDIVIDUAL — индивидуальный предприниматель;

* FOREIGN\_LEGAL — иностранное юридическое лицо;

* FOREIGN\_PHYSICAL — иностранное физическое лицо.

|

Да

||
||

`Tin`

|

string

|

Номер налогоплательщика либо его аналог в стране регистрации.

|

Да

||
|#


## Ответ {#output}

Структура ответа в формате JSON:

```json translate=no
{
  "result": {
    "Login": (string),
    "ClientId": (long),
    "Warnings": [{
      "Code": (int),
      "Message": (string),
      "Details": (string)
    }, ... ],
    "Errors": [{
      "Code": (int),
      "Message": (string),
      "Details": (string)
    }, ... ]
  }
}

```


#|
||
**Параметр**
|
**Тип**
|
**Описание**
||
||
**Структура result (для JSON) / AddPassportOrganizationResponse (для SOAP)**
|
>
|
>
||
||
`Login`
|
string
|
Логин пользователя Директа — главного представителя рекламодателя. Возвращается в случае отсутствия ошибок, см. раздел [Операции над массивом объектов](https://yandex.ru/dev/direct/doc/dg/best-practice/modify.html).
||
||
`ClientId`
|
long
|
Идентификатор созданного рекламодателя. Возвращается в случае отсутствия ошибок.
||
||
`Warnings`
|
array of ExceptionNotification
|
Предупреждения, возникшие при выполнении операции.
||
||
`Errors`
|
array of ExceptionNotification
|
Ошибки, возникшие при выполнении операции.
||
|#