/unibox/threads/by-lead/{leadId} Authentication
Send your organization API key as a Bearer credential.
Authorization: Bearer YOUR_API_KEY Path parameters
leadId number required Lead ID
22092194 Response
application/json Thread retrieved successfully
id number required Unique ID of the email thread
999 is_archive boolean required Indicates whether the thread is archived
false lead_id number required ID of the lead associated with this thread
22092194 campaign_id string required ID of the campaign associated with this thread
c8a7b9d2-1234-5678-9999-abcdef123456 user_id number ID of the user who owns the thread
42 organization_id string Organization that owns the thread
11111111-1111-4111-8111-111111111111 created_at string Thread creation timestamp
2025-12-08T10:00:00.000Z updated_at string Thread update timestamp
2025-12-08T11:00:00.000Z last_reply_message_id number ID of the latest reply message
555 last_message_date_sent string Timestamp of the latest message
2025-12-08T11:30:00.000Z emails object[] required List of emails belonging to this thread
Show child attributes
emails.id number required Unique ID of the email record
123 emails.thread_id number required ID of the thread this email belongs to
999 emails.date_sent string required Date and time when the email was sent
2025-12-08T12:00:00.000Z emails.from_name string required Name of the sender
John Doe emails.from_email string required Sender email address
john@example.com emails.to_email string required Recipient email address
lead@example.com emails.body string required Body content of the email
Hello, this is message body emails.subject string required Subject of the email
Subject text emails.is_our_email boolean required Indicates whether this email was sent by our system
false emails.is_new boolean required Indicates whether this email is marked as new/unread
true emails.message_id string required Unique Message-ID from email headers
<message-id@mail.com> emails.cc_email string required Carbon copy (CC) email addresses
cc@example.com emails.attachments object[] required Attachments belonging to this email. Empty array if the email has no attachments.
Show child attributes
emails.attachments.id number required Unique ID of the attachment
1 emails.attachments.unibox_email_id number ID of the email this attachment belongs to
123 emails.attachments.type number required Attachment type. 1 — Generic, 2 — Personalised
1 emails.attachments.ext string required File extension (without the leading dot)
pdf emails.attachments.original_filename string Legacy original filename field
proposal.pdf emails.attachments.saving_filename string Legacy stored filename field
a1b2c3d4-5678-90ab-cdef-1234567890ab.pdf emails.attachments.filename string required Original filename as uploaded by the user
proposal.pdf emails.attachments.url string required Permanent public CDN URL
https://cdn.coldytrack.com/coldy-content/a1b2c3d4.pdf Invalid request body (e.g. missing required fields, or invalid field values)
message string[] required List of detailed validation or business error messages
["Name cannot be empty", "Field must be greater than 0"] error string required Short error description
Bad Request statusCode number required HTTP status code of the error
400 This request is unauthorized (either the Authorization header is missing or invalid, or the API key has been revoked)
message string[] required List of messages explaining why the request was unauthorized
["User is not authorized", "Invalid API key"] error string required Short error description
Unauthorized statusCode number required HTTP status code of the error
401 Campaign not found or inaccessible to this organization
message string[] required ["Campaign not found"] error string required Not Found statusCode number required 404 You have exceeded the rate limit. Please check the rate limit docs for more information.
message string[] required List of messages explaining the rate limiting issue
["Too many requests, please try again later"] error string required Short error description
Too Many Requests statusCode number required HTTP status code of the error
429