Получить тред по лиду

GET /unibox/threads/by-lead/{leadId}

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

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

Authorization: Bearer YOUR_API_KEY

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

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

ID лида

Пример: 22092194

Ответ

application/json

Тред успешно получен

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

Уникальный ID треда.

Пример: 999

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

Указывает, заархивирован ли тред

Пример: false

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

ID лида, связанного с тредом

Пример: 22092194

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

ID рассылки, связанной с тредом

Пример: c8a7b9d2-1234-5678-9999-abcdef123456

user_id number

ID пользователя — владельца треда

Пример: 42

organization_id string

Организация — владелец треда

Пример: 11111111-1111-4111-8111-111111111111

created_at string

Время создания треда

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

updated_at string

Время обновления треда

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

last_reply_message_id number

ID последнего ответного сообщения

Пример: 555

last_message_date_sent string

Время последнего сообщения

Пример: 2025-12-08T11:30:00.000Z

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

Список писем в треде

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

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

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

Пример: 123

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

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

Пример: 999

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

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

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

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

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

Пример: John Doe

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

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

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

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

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

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

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

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

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

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

Тема письма

Пример: Subject text

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

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

Пример: false

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

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

Пример: true

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

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

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

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

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

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

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

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

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

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

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

Пример: 1

emails.attachments.unibox_email_id number

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

Пример: 123

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

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

Пример: 1

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

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

Пример: pdf

emails.attachments.original_filename string

Прежнее поле исходного имени файла

Пример: proposal.pdf

emails.attachments.saving_filename string

Прежнее поле сохраненного имени файла

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

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

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

Пример: proposal.pdf

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

Постоянный публичный CDN URL

Пример: https://cdn.coldytrack.com/coldy-content/a1b2c3d4.pdf

Запрос

curl --request GET \
  --url https://developer.coldy.ai/api/v1/unibox/threads/by-lead/{leadId} \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Accept: application/json'

{
  "id": 999,
  "is_archive": false,
  "lead_id": 22092194,
  "campaign_id": "c8a7b9d2-1234-5678-9999-abcdef123456",
  "user_id": 42,
  "organization_id": "11111111-1111-4111-8111-111111111111",
  "created_at": "2025-12-08T10:00:00.000Z",
  "updated_at": "2025-12-08T11:00:00.000Z",
  "last_reply_message_id": 555,
  "last_message_date_sent": "2025-12-08T11:30:00.000Z",
  "emails": [
    {
      "id": 123,
      "thread_id": 999,
      "date_sent": "2025-12-08T12:00:00.000Z",
      "from_name": "John Doe",
      "from_email": "john@example.com",
      "to_email": "lead@example.com",
      "body": "Hello, this is message body",
      "subject": "Subject text",
      "is_our_email": false,
      "is_new": true,
      "message_id": "<message-id@mail.com>",
      "cc_email": "cc@example.com",
      "attachments": [
        {
          "id": 1,
          "unibox_email_id": 123,
          "type": 1,
          "ext": "pdf",
          "original_filename": "proposal.pdf",
          "saving_filename": "a1b2c3d4-5678-90ab-cdef-1234567890ab.pdf",
          "filename": "proposal.pdf",
          "url": "https://cdn.coldytrack.com/coldy-content/a1b2c3d4.pdf"
        }
      ]
    },
    {
      "id": 124,
      "thread_id": 999,
      "date_sent": "2025-12-08T12:30:00.000Z",
      "from_name": "Jane Lead",
      "from_email": "lead@example.com",
      "to_email": "john@example.com",
      "body": "Reply without attachments",
      "subject": "Re: Subject text",
      "is_our_email": false,
      "is_new": true,
      "message_id": "<reply-id@mail.com>",
      "cc_email": "",
      "attachments": []
    }
  ]
}

{
  "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"
}