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

# CreateNewSubclient
Registers a client of an advertising agency in Yandex and creates an account in Yandex Direct.

{% note alert %}

Disabled method. Use version 5 of the API.

For information about the compatibility of methods between versions 4 and 5, see the [Migration guide](https://yandex.com/dev/direct/doc/migration/concepts/methods.md).

{% endnote %}


This method is available only to advertising agencies, not to direct advertisers. For agencies, access is provided on request.


{% note alert %}

As of October 10, 2016, advertising agencies can only register clients who are using a real currency. Registration of clients who use Yandex units has been disabled. Accordingly, the logic of the method has changed.

If the agency has a single currency available, the client is created in the agency's currency.

If the agency has multiple currencies available, the method returns an error. In this case, a client can be registered only by using the [CreateNewSubclient (Live)](https://yandex.ru/dev/direct/doc/dg-v4/en/live/CreateNewSubclient.md) method or in the web interface.

Available currencies are shown in the ClientCurrencies output parameter for the [GetClientInfo (Live)](https://yandex.ru/dev/direct/doc/dg-v4/en/live/GetClientInfo.md) method.

{% endnote %}


The [CreateNewSubclient (Live)](https://yandex.ru/dev/direct/doc/dg-v4/en/live/CreateNewSubclient.md) version also exists for this method.

## Restrictions

No more than 100 clients can be registered per day.


## Input data {#input}

The input data structure in JSON is shown below.

```javascript
{
   "method": "CreateNewSubclient",
   "param": {
      /* CreateNewSubclientRequest */
      "Login": (string),
      "Name": (string),
      "Surname": (string)
   }
}
```

Parameters are described below.


#|
||
**<sup >Parameter</sup>**
|
**<sup >Description</sup>**
|
**<sup >Required</sup>**
||

||
**<sub >CreateNewSubclientRequest object</sub>**
||
||
`Login`
|
Client's username (unique within Yandex).

The user's Yandex account is created for this username. If the username is not unique, the error message [252](https://yandex.ru/dev/direct/doc/dg-v4/en/reference/ErrorCodes.md#ErrorCode252) is returned.
|
Yes
||
||
`Name`
|
Client's name, no more than 20 characters. The following characters are not allowed: `&``=``<``>`.
|
Yes
||
||
`Surname`
|
Client's last name, no more than 20 characters. The following characters are not allowed: `&``=``<``>`.
|
Yes
||
|#


## Output data {#output}

The output data structure in JSON is shown below.

```javascript
{
   "data": {
      /* CreateNewSubclientResponse */
      "Login": (string),
      "Password": (string),
      "FIO": (string),
      "Email": (string),
      "ClientID": (int)
   }
}
```

Parameters are described below.


#|
||
**<sup >Parameter</sup>**
|
**<sup >Description</sup>**
||

||
**<sub >CreateNewSubclientResponse object</sub>**
||
||
`Login`
|
The Yandex username.
||
||
`Password`
|
Automatically generated password.

The client can use this password and username to log in on Yandex.
||
||
`FIO`
|
Last name and initials.
||
||
`Email`
|
The email address to send notifications and news to.
||
||
`ClientID`
|
Client ID.
||
|#


## Examples of input data {#example}

## Python

```python
{
   'Login': 'agrom',
   'Name': 'Alexander',
   'Surname': 'Gromov'
}
```

## PHP

```php
array(
   'Login' => 'agrom',
 'Name' => 'Alexander',
 'Surname' ='Gromov'
)
```

## Perl

```perl
{
 'Login' => 'agrom',
 'Name' => 'Alexander',
 'Surname' ='Gromov'
}
```