# Calltouch API: POST /calls-service/RestAPI/requests/{siteId}/register/ — Создание заявки

Токен не нужен; поддерживается и GET. Тело — `application/x-www-form-urlencoded`, UTF-8, одна заявка за запрос. Нужен хотя бы один из `fio`, `phoneNumber`, `email`.

| Параметр | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
| `siteId` | path | integer | да | ID личного кабинета |
| `subject` | body | string | нет | Название формы, до 256 символов |
| `requestNumber` | body | string | нет | Ваш ID заявки, до 256 символов |
| `requestDate` | body | string | нет | dd.mm.yyyy hh:mm:ss; по умолчанию — текущее время |
| `sessionId` | body | string | нет | ID сессии Calltouch (window.ct('calltracking_params','mod_id').sessionId) |
| `fio` | body | string | нет | Имя клиента |
| `phoneNumber` | body | string | нет | Телефон из 11 цифр |
| `email` | body | string | нет | Email |
| `comment` | body | string | нет | Комментарий |
| `tags` | body | string | нет | Теги через запятую |
| `requestUrl` | body | string | нет | Адрес страницы формы |
| `customField[fieldName]` | body | string | нет | Пользовательское поле (до 100 символов) |

## Базовые URL

- Боевой: `https://api.calltouch.ru`
- Методы: `/calls-service/RestAPI/`

## Авторизация

Тип: API-ключ

API-токен (45 символов) и `siteId` (ID личного кабинета) берутся в разделе «Интеграции» → «API». Токен передаётся параметром `clientApiId`. Для создания заявок с сайта токен не нужен.

```
https://api.calltouch.ru/calls-service/RestAPI/{siteId}/calls-diary/calls?clientApiId={токен}&dateFrom=22/11/2016&dateTo=22/11/2016&withCallTags=true&withMapVisits=true
```

## Нюансы

- Имена параметров чувствительны к регистру.
- Форматы дат различаются: журнал звонков — `dd/mm/yyyy`, журнал заявок — `mm/dd/yyyy`, создание заявки — `dd.mm.yyyy hh:mm:ss`.
- Данные Яндекс Директа и Google Ads появляются на следующий день после звонка; теги Predict и Antifrod — примерно через неделю.
- Каждый ответ содержит заголовок `Api-Point`: «потрачено / осталось часовых / осталось суточных», например `Api-Point: 4/5256/102368`.
- Поля ответа, не описанные в документации, устарели — их нужно игнорировать.

## Сценарии с этим методом

- [Передать заявку с сайта в Calltouch](https://mcp-everything.ru/integrations/calltouch/scenarios/peredat-zayavku-s-sayta-v-calltouch.md)

---

Если этого недостаточно — официальная документация: https://www.calltouch.ru/support/api-metod-vygruzki-zhurnala-zvonkov/
Вся интеграция одним документом: https://mcp-everything.ru/integrations/calltouch.md