Начало
API FormToMail предназначен для отправки форм с вашего сайта на электронную почту и Telegram.
Базовый URL: https://api.formtomail.ru.
Авторизация — заголовком Authorization: Bearer ВАШ_КЛЮЧ (ключ публичный, берётся в кабинете).
На бесплатном тарифе запросы принимаются с любых ресурсов, на платном — только с указанного домена.
Форма без вложений
Метод
POST https://api.formtomail.ru/sendHeaders
Authorization: Bearer YOUR_API_KEY Авторизация по ключу. Ключ является публичным. Стартовый (бесплатный) тариф предназначен для тестирования и разработки, принимает запросы с любых ресурсов. При оплате ключа запросы принимаются только с указанного домена. |
| Content-Type: application/json |
Body (application/json) — JSON-объект со свойствами:
title (string, необязательно) Заголовок формы. То, что вы увидите первым (например: "Новая заявка"). |
body ({ [key: string]: Смотреть на странице форматирования }, обязательно) Форма в виде объекта. Ключи объекта — это описания полей, а значения — сами данные в формате, описанном на странице форматирования полей |
honeypot (any, необязательно) Необязательное поле для защиты от ботов. Смотреть больше на странице «Антибот» |
Пример кода (JS)
const response = await fetch("https://api.formtomail.ru/send", { method: "POST", headers: { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, body: JSON.stringify({ title: "Новая заявка", body: { "Имя": "значение поля", "Телефон": "значение поля" } }) }); const body = await response.json();
Ответ API
200 OK — форма успешно отправлена. Ответ (JSON):
{ "statusCode": 200, "message": "Успешно отправлено" }
400 Bad Request — ошибка, которую стоит показать пользователю. Пример (JSON):
{ "statusCode": 400, "message": "Отправить можно не более 10 файлов" }
Другая ошибка — не стоит показывать пользователю. Пример (JSON):
{ "statusCode": 403, "message": "Срок обслуживания истек" }
Защита от ботов
Honeypot
Добавьте в форму скрытое поле-ловушку и отправляйте его значение отдельным свойством honeypot в теле запроса (не в свойстве body тела запроса). Люди его не видят и оставляют пустым, а боты заполняют. Если поле непустое — сервер вернёт успех, но письмо не отправит. Проверок на клиенте делать не нужно.
honeypot (any, необязательно) Значение скрытого поля. Пустое = человек, непустое = бот (письмо не отправляется, но возвращается 200). |
Спам-фразы
Вы можете добавить проверку встречаются ли популярные спам-фразы. Ниже есть пример реализации такой проверки: если есть что-то из spamPhrases (например, «если не отвечу на звонок»), запрос не отправляется. Это клиентская мера: она отсекает шаблонный спам, но её можно обойти.
Пример (без вложений)
<form id="form"> <input id="name" placeholder="Иван Иванов"> <textarea id="message" placeholder="Сообщение"></textarea> <input type="text" name="company_website" autocomplete="off" tabindex="-1" aria-hidden="true" style="position:absolute;left:-9999px;top:auto;width:1px;height:1px;overflow:hidden;"> <button type="submit">Отправить</button> </form> <script> document.getElementById("form").addEventListener("submit", async (event) => { event.preventDefault(); // Отсечение по спам-фразе: шаблонный текст от бота не отправляем const spamPhrases = ["если не отвечу на звонок"]; const message = document.getElementById("message").value.toLowerCase(); if (spamPhrases.some((phrase) => message.includes(phrase.toLowerCase()))) { // Показываем боту успех, чтобы он не подбирал обход console.log({ statusCode: 200, message: "Успешно отправлено" }); return; } const response = await fetch("https://api.formtomail.ru/send", { method: "POST", headers: { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, body: JSON.stringify({ body: { "Имя": document.getElementById("name").value, "Сообщение": document.getElementById("message").value }, honeypot: document.querySelector('[name="company_website"]').value }) }); console.log(await response.json()); }); </script>
Пример с FormData
<form id="form"> <input id="name" placeholder="Иван Иванов"> <textarea id="message" placeholder="Сообщение"></textarea> <input type="text" name="company_website" autocomplete="off" tabindex="-1" aria-hidden="true" style="position:absolute;left:-9999px;top:auto;width:1px;height:1px;overflow:hidden;"> <button type="submit">Отправить</button> </form> <script> document.getElementById("form").addEventListener("submit", async (event) => { event.preventDefault(); // Отсечение по спам-фразе: шаблонный текст от бота не отправляем const spamPhrases = ["если не отвечу на звонок"]; const message = document.getElementById("message").value.toLowerCase(); if (spamPhrases.some((phrase) => message.includes(phrase.toLowerCase()))) { // Показываем боту успех, чтобы он не подбирал обход console.log({ statusCode: 200, message: "Успешно отправлено" }); return; } const formData = new FormData(); formData.append("body", JSON.stringify({ "Имя": document.getElementById("name").value, "Сообщение": document.getElementById("message").value })); formData.append("honeypot", document.querySelector('[name="company_website"]').value); const response = await fetch("https://api.formtomail.ru/send", { method: "POST", headers: { "Authorization": "Bearer YOUR_API_KEY" // Content-Type не указываем — браузер сам выставит multipart/form-data с boundary }, body: formData }); console.log(await response.json()); }); </script>
Форма с вложениями
Метод
POST https://api.formtomail.ru/sendHeaders
Authorization: Bearer YOUR_API_KEY Авторизация по ключу. Ключ является публичным. Стартовый (бесплатный) тариф предназначен для тестирования и разработки, принимает запросы с любых ресурсов. При оплате ключа запросы принимаются только с указанного домена. |
Body (multipart/form-data)
attachments (File[], необязательно) Массив файлов, передаваемых с запросом. Для корректной передачи имён файлов кодируйте имя файла с помощью |
title (string, необязательно) Заголовок формы. То, что вы увидите первым (например: "Новая заявка"). |
body ({ [key: string]: Смотреть на странице форматирования }, обязательно) Форма в виде объекта. Ключи объекта — это описания полей, а значения — сами данные в формате, описанном на странице форматирования полей |
honeypot (any, необязательно) Необязательное поле для защиты от ботов. Смотреть больше на странице «Антибот» |
Ограничения
| Максимальное количество файлов: 10 |
| Максимальный объём всех файлов: 20MB |
| Расширения: .jpg, .jpeg, .png, .webp, .bmp, .gif, .mov, .mp4, .pdf, .xls, .xlsx, .doc, .docx |
const SUPPORTED_EXTENSIONS = ["jpg", "jpeg", "png", "webp", "bmp", "gif", "mov", "mp4", "pdf", "xls", "xlsx", "doc", "docx"];
Пример кода (JS)
const formData = new FormData(); formData.append("title", "Новая заявка"); formData.append("body", JSON.stringify({ "Имя": "значение поля", "Телефон": "значение поля" })); // Пример добавления файлов const SUPPORTED_EXTENSIONS = ["jpg", "jpeg", "png", "webp", "bmp", "gif", "mov", "mp4", "pdf", "xls", "xlsx", "doc", "docx"]; const filesInput = document.getElementById("files"); const files = Array.from(filesInput.files); for (const file of files) { const extension = file.name.split(".").pop()?.toLowerCase(); if (!extension || !SUPPORTED_EXTENSIONS.includes(extension)) { continue; // неподдерживаемый тип } formData.append("attachments", file, encodeURIComponent(file.name)); } const response = await fetch("https://api.formtomail.ru/send", { method: "POST", headers: { "Authorization": "Bearer 5LOLtMTAycDwPEeY" // Content-Type не указываем — браузер сам выставит multipart/form-data с boundary }, body: formData, }); const body = await response.json();
Ответ API
200 OK — форма успешно отправлена. Ответ (JSON):
{ "statusCode": 200, "message": "Успешно отправлено" }
400 Bad Request — ошибка, которую стоит показать пользователю. Пример (JSON):
{ "statusCode": 400, "message": "Отправить можно не более 10 файлов" }
Другая ошибка — не стоит показывать пользователю. Пример (JSON):
{ "statusCode": 403, "message": "Срок обслуживания истек" }
Форматирование полей
В представленных примерах верхняя часть — ключ и значение JS объекта, нижняя — как это выглядит в письме. Никакая таблица не может быть вложена в другой элемент, остальные элементы могут быть вложены.
HTML
В любой строке в body, кроме названий полей, можно использовать HTML. В этом примере представлены все разрешённые тэги:
"Обращение": `<p>Абзац с <b>жирным</b>, <strong>важным</strong>, <i>курсивом</i>, <em>акцентом</em>, <u>подчёркиванием</u>, <s>зачёркиванием</s>, <del>удалённым</del>, <code>кодом</code>, <a href="https://example.com">ссылкой</a> и<br>переносом строки.</p> <blockquote>Цитата</blockquote> <pre>Блок кода</pre> <ul><li>Пункт списка</li></ul> <hr> <ol start="3"><li>Пункт нумерованного списка</li></ol>`
Абзац с жирным, важным, курсивом, акцентом, подчёркиванием, зачёркиванием, удалённым, кодом, ссылкой и
переносом строки.
Цитата
Блок кода
- Пункт списка
- Пункт нумерованного списка
Boolean
"Самовывоз": true
"Самовывоз": false
Число
"Коэффициент": 10.5
Маркированный список
"Добавки": ["Лук", "Сырный соус"]
- Лук
- Сырный соус
Таблица
"Корзина": [ ["Товар", "Цена", "Кол-во", "Сумма"], ["Футболка", "1 500 ₽", "2", "3 000 ₽"], ["Кроссовки", "5 000 ₽", "1", "5 000 ₽"], ["<b>Итого</b>", "", "", "<b>8 000 ₽</b>"] ]
| Товар | Цена | Кол-во | Сумма |
|---|---|---|---|
| Футболка | 1 500 ₽ | 2 | 3 000 ₽ |
| Кроссовки | 5 000 ₽ | 1 | 5 000 ₽ |
| Итого | 8 000 ₽ |
Таблица ключ-значение
"Характеристики": { "Процессор": "AMD Ryzen 7 7800X3D", "Видеокарта": "NVIDIA GeForce RTX 4070", "Оперативная память": "32 ГБ DDR5", "Накопитель": "1 ТБ NVMe SSD" }
| Процессор | AMD Ryzen 7 7800X3D |
| Видеокарта | NVIDIA GeForce RTX 4070 |
| Оперативная память | 32 ГБ DDR5 |
| Накопитель | 1 ТБ NVMe SSD |
Webhook — отправка в ваш API (тариф с хуком)
Webhook нужен, чтобы заявки сразу попадали в вашу систему: российские CRM (Битрикс24, amoCRM, retailCRM, Мегаплан), 1С и МойСклад, Google Sheets, свой backend или Telegram-бота — везде, где есть HTTP API, принимающий JSON. Не нужно забирать письма с почты и переносить данные вручную: форма с сайта за секунды оказывается в воронке продаж, таблице или чате.
Если оплачен тариф с хуком, каждая форма параллельно уходит JSON'ом на ваш URL: Authorization: Bearer <ваш токен>. JSON для хука вы готовите сами и передаёте полем webhook вместе с формой. Файлы в хук не входят — они идут только на почту и в Telegram.
// JSON для хука клиент собирает сам и передаёт полем webhook вместе с формой const webhook = { client_name: document.getElementById("name").value, phone: document.getElementById("phone").value, source: "landing" }; const response = await fetch("https://api.formtomail.ru/send", { method: "POST", headers: { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, body: JSON.stringify({ title: "Новая заявка", body: { "Имя": document.getElementById("name").value, "Телефон": document.getElementById("phone").value }, webhook: webhook }) });
- Тестового периода для хука нет — нужен тариф с хуком (без лимитов).
- Ваш API должен отвечать
200за <2с и проверятьBearer.
Примечание: если хук включён, а поле webhook не передано — на ваш API уходит объект формы как есть (title + body).