> For the complete documentation index, see [llms.txt](https://docs.leadconverter.su/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.leadconverter.su/api-metody/email/addsubscriber.md).

# addSubscriber

## Добавление нового подписчика

<mark style="color:green;">`POST`</mark> `https://leadconverter.ru/api/v1/токен/email.addSubscriber`

Добавляет подписчика в базу рассылки.\
\
Опционально: можно указать, какие переменные нужно присвоить подписчику (параметр variables)\
Опционально: можно указать, какого бота запустить подписчику (параметр bot\_id)

#### Query Parameters

| Name         | Type    | Description                                                                                                                                                                                                                                                                                       |
| ------------ | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| channel\_id  | string  | ID канала подписчика                                                                                                                                                                                                                                                                              |
| email        | string  | Email подписчика                                                                                                                                                                                                                                                                                  |
| variable     | array   | <p><strong>Ассоциативный массив</strong> переменных, которые будут установлены перед добавлением<br>ключ массива - имя переменной<br>Например:<br><em>variable\[var\_1]=qwe\&variable\[var\_2]=123</em> <br>установит<br>переменную var\_1 в значение qwe<br>переменную var\_2 в значение 123</p> |
| bot\_id      | integer | ID бота, которого нужно запустить после добавления                                                                                                                                                                                                                                                |
| first\_name  | string  | Имя подписчика                                                                                                                                                                                                                                                                                    |
| last\_name   | string  | Фамилия подписчика                                                                                                                                                                                                                                                                                |
| from         | string  | from-метка подписчика                                                                                                                                                                                                                                                                             |
| utm\_\*      | string  | <p>UTM-метки подписчика<br>Вместо \* можно использовать source, medium, content, campaign и term.</p>                                                                                                                                                                                             |
| openstat\_\* | string  | <p>Openstat-метки подписчика<br>Вместо \* можно использовать service, campaign, ad, source</p>                                                                                                                                                                                                    |

{% tabs %}
{% tab title="200 " %}

```
ok
```

{% endtab %}

{% tab title="404 Если ID канала не будет найден - будет возвращен отклик" %}

```
Channel not found
```

{% endtab %}

{% tab title="422 Если подписчик с таким email уже существует в этом канале будет получен отклик" %}

```
Subscriber with email "email" already exists in this channel
```

{% endtab %}
{% endtabs %}

Если не знаешь, где взять channel\_id - тебе сюда [Как узнать channel\_id (ID канала)](/faq/populyarnye-voprosy/obshie-voprosy/kak-uznat-id-kanala.md)  :)

### Не нашёл метода который тебе нужен?

Напиши в поддержку, мы подумаем, чем сможем помочь тебе. По необходимости - добавим.

### Остались вопросы?

Чего же ты ждёшь, пиши нам :blush:&#x20;

{% content-ref url="/pages/-MasAPNcg291uNezFqb4" %}
[Как задать вопрос в поддержку?](/kak-zadat-vopros-v-podderzhku.md)
{% endcontent-ref %}