Переслать письмо

POST /unibox/emails/{emailId}/forward

Аутентификация

Передавайте API-ключ организации как Bearer-токен.

Authorization: Bearer YOUR_API_KEY

Параметры пути

emailId number обязательное

ID письма Unibox, которое нужно переслать

Пример: 12345

Тело запроса

application/json

Данные для пересылки письма

from_email string обязательное

Адрес подключённого аккаунта отправителя

Пример: sales@company.com

to_email string обязательное

Адрес нового основного получателя

Пример: recipient@example.com

message string

Необязательный комментарий перед пересылаемым письмом

Пример: Please take a look at this email.

Ответ

application/json

Письмо успешно переслано

id number обязательное

Уникальный ID записи email.

Пример: 123

thread_id number обязательное

ID треда, к которому относится письмо

Пример: 999

date_sent string обязательное

Дата и время отправки электронного письма

Пример: 2025-12-08T12:00:00.000Z

from_name string обязательное

Имя отправителя

Пример: John Doe

from_email string обязательное

Адрес email отправителя

Пример: john@example.com

to_email string обязательное

Адрес email получателя

Пример: lead@example.com

body string обязательное

Содержимое письма

Пример: Hello, this is message body

subject string обязательное

Тема письма

Пример: Subject text

is_our_email boolean обязательное

Указывает, было ли это письмо отправлено нашей системой.

Пример: false

is_new boolean обязательное

Указывает, помечено ли это письмо как new/unread.

Пример: true

message_id string обязательное

Уникальное сообщение ID из заголовков email.

Пример: <message-id@mail.com>

cc_email string обязательное

Электронная копия (CC) адресов email

Пример: cc@example.com

attachments object[] обязательное

Вложения, принадлежащие этому электронному письму. Пустой массив, если письмо не имеет вложений.

Показать вложенные поля Скрыть вложенные поля

attachments.id number обязательное

Уникальный ID вложения

Пример: 1

attachments.unibox_email_id number обязательное

ID электронного письма, которому принадлежит это вложение

Пример: 123

attachments.type number обязательное

Тип прикрепления. 1 — Общий, 2 — Персонализированный

Пример: 1

attachments.ext string обязательное

Расширение файла (без начальной точки)

Пример: pdf

attachments.original_filename string обязательное

Исходное имя файла, загруженное пользователем

Пример: proposal.pdf

attachments.saving_filename string обязательное

Имя файла внутренней памяти, используемое системой

Пример: a1b2c3d4-5678-90ab-cdef-1234567890ab.pdf

Запрос

curl --request POST \
  --url https://developer.coldy.ai/api/v1/unibox/emails/{emailId}/forward \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "from_email": "sales@company.com",
  "to_email": "recipient@example.com",
  "message": "Please take a look at this email."
}'

{
  "id": 67890,
  "thread_id": 999,
  "date_sent": "2026-08-13T10:00:00.000Z",
  "cc_email": null,
  "from_name": "Sales Team",
  "from_email": "sales@company.com",
  "to_email": "recipient@example.com",
  "body": "<div>Forwarded message</div>",
  "subject": "Fwd: Original subject",
  "is_our_email": true,
  "is_new": false,
  "message_id": "<new-message-id@example.com>",
  "attachments": [
    {
      "id": 12,
      "unibox_email_id": 67890,
      "type": 1,
      "ext": "pdf",
      "original_filename": "proposal",
      "saving_filename": "stored-proposal.pdf"
    }
  ]
}

{
  "message": [
    "You put invalid API key. Verify your key with the key from your account in Coldy. Check documenation for info"
  ],
  "statusCode": 400,
  "error": "Invalid API key"
}