--- metadata: - name: generator content: Diplodoc Platform v5.52.0 alternate: - https://yandex.com/dev/direct/doc/en/agencyclients/add.md - https://yandex.com/dev/direct/doc/ru/agencyclients/add.md - href: ru/agencyclients/add.md type: text/markdown title: Markdown version - href: ../llms.txt type: text/markdown title: llms.txt sourcePath: ru/ref-v5/agencyclients/add.md --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/direct/doc/ru/llms.txt # add {% note alert %} Метод не поддерживается. Вместо него используется метод [addPassportOrganization](https://yandex.ru/dev/direct/doc/ru/agencyclients/addPassportOrganization). {% endnote %} Регистрирует новых рекламодателей — клиентов агентства, а также пользователей — главных представителей рекламодателя. {% note info %} В запросе к сервису `AgencyClients`: - В HTTP-заголовке `Authorization` укажите токен, полученный для представителя агентства. - HTTP-заголовок `Client-Login` не указывайте. {% endnote %} ## Узнайте больше - [Клиент (Client)](https://yandex.ru/dev/direct/doc/dg/objects/client.html) - [Роли и доступы пользователей Директа](https://yandex.ru/dev/direct/doc/dg/objects/roles.html) - [Как работает метод add](https://yandex.ru/dev/direct/doc/dg/best-practice/modify.html) - [Как обрабатывать ошибки](https://yandex.ru/dev/direct/doc/dg/concepts/errors.html) ## Ограничения {#restrictions} Не более 100 клиентов в день. Доступ к методу предоставляется [по заявке](https://yandex.ru/dev/direct/doc/support/troubleshooting/add-client.html). ## Запрос {#input} Структура запроса в формате JSON: ```javascript translate=no { "method": "add", "params": { /* params */ "Login": (string), /* required */ "FirstName": (string), /* required */ "LastName": (string), /* required */ "Currency": ( "RUB" | "BYN" | "CHF" | "EUR" | "KZT" | "TRY" | "UAH" | "USD" ), /* required */ "Grants": [{ /* GrantItem */ "Privilege": ( "EDIT_CAMPAIGNS" | "IMPORT_XLS" | "TRANSFER_MONEY" ), /* required */ "Value": ( "YES" | "NO" ) /* required */ }, ... ], "Notification": { /* NotificationAdd */ "Lang": ( "RU" | "UK" | "EN" | "TR" ), /* required */ "Email": (string), /* required */ "EmailSubscriptions": [{ /* EmailSubscriptionItem */ "Option": ( "RECEIVE_RECOMMENDATIONS" | "TRACK_MANAGED_CAMPAIGNS" | "TRACK_POSITION_CHANGES" ), /* required */ "Value": ( "YES" | "NO" ) /* required */ }, ... ] /* required */ }, /* required */ "Settings": [{ /* ClientSettingAddItem */ "Option": ( "CORRECT_TYPOS_AUTOMATICALLY" | "DISPLAY_STORE_RATING" ), /* required */ "Value": ( "YES" | "NO" ) /* required */ }, ... ], "TinInfo": { /* TinInfoAdd */ "TinType": ( "PHYSICAL" | "FOREIGN_PHYSICAL" | "LEGAL" | "FOREIGN_LEGAL" | "INDIVIDUAL" ), /* required */ "Tin": (string) } } } ``` #| || **Параметр** | **Тип** | **Описание** | **Обязательный** || || **Структура params (для JSON) / AddRequest (для SOAP)** | > | > | > || || `Login` | string | Логин пользователя Директа — главного представителя рекламодателя. По указанному логину создается пользователь на Яндексе и в Директе, поэтому допускается только незанятый логин. Логин может состоять из латинских символов, цифр, одинарного дефиса или точки. Он должен начинаться с буквы, заканчиваться буквой или цифрой и содержать не более 30 символов. Не рекомендуется использовать в логине точки (их следует заменять дефисами) и символы верхнего регистра. | Да || || `FirstName` | string | Имя пользователя (не более 20 символов). Не допускаются символы &=<>. | Да || || `LastName` | string | Фамилия пользователя (не более 20 символов). Не допускаются символы &=<>. | Да || || `Currency` | CurrencyEnum | Валюта рекламодателя. | Да || || `Grants` | array of GrantItem | Полномочия рекламодателя по управлению кампаниями. Если не заданы — полномочия отсутствуют. | Нет || || `Notification` | NotificationAdd | Настройки SMS- и 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: ```javascript translate=no { "result": { /* result */ "Login": (string), "Password": (string), "Email": (string), "ClientId": (long), "Warnings": [{ /* ExceptionNotification */ "Code": (int), /* required */ "Message": (string), /* required */ "Details": (string) }, ... ], "Errors": [{ /* ExceptionNotification */ "Code": (int), /* required */ "Message": (string), /* required */ "Details": (string) }, ... ] } } ``` #| || **Параметр** | **Тип** | **Описание** || || **Структура result (для JSON) / AddResponse (для SOAP)** | > | > || || `Login` | string | Логин пользователя Директа — главного представителя рекламодателя. Возвращается в случае отсутствия ошибок, см. раздел [Операции над массивом объектов](https://yandex.ru/dev/direct/doc/dg/best-practice/modify.html). || || `Password` | string | Автоматически сгенерированный пароль пользователя. Возвращается в случае отсутствия ошибок. || || `Email` | string | Автоматически сгенерированный на основе логина адрес электронной почты. Возвращается в случае отсутствия ошибок. || || `ClientId` | long | Идентификатор созданного рекламодателя. Возвращается в случае отсутствия ошибок. || || `Warnings` | array of ExceptionNotification | Предупреждения, возникшие при выполнении операции. || || `Errors` | array of ExceptionNotification | Ошибки, возникшие при выполнении операции. || |#