Get email threads (conversations)

GET

https://api.plusvibe.ai/api/v1/unibox/threads

Your inbox as conversations — one item per thread with its state (latest_message_type, is_unread, is_starred, is_archived, has_draft) and a preview of the latest message. Start here.

latest_message_type=received lists conversations where the lead spoke last — typically those that may still need an answer (note: this also includes conversations you intentionally left; combine with label to narrow). All filters can be combined.

Read full messages: GET /unibox/emails?thread_id=... Reply: POST /unibox/emails/reply with latest_message.id as reply_to_id.

Reset page_trail to "" whenever you change filters.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Query Params

Responses

🟢200OK

application/json

Bodyapplication/json

🟠400Bad Request

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.plusvibe.ai/api/v1/unibox/threads?workspace_id=undefined&latest_message_type=undefined&is_unread=undefined&is_starred=undefined&is_archived=undefined&has_draft=undefined&lead=undefined&campaign_id=undefined&label=undefined&limit=undefined&page_trail=undefined' \
--header 'x-api-key: <api-key>'

Response Example

200 - Example 1

{
    "page_trail": "MTcyMDA4MzQ1Njc4OXw2NmI5ZDc4ZmY5MWZhYmY5MjBmNjk2NGQ",
    "data": [
        {
            "thread_id": "66b9d78ff91fabf920f6964d",
            "lead": "lead@example.com",
            "lead_id": "65f3c92d3dbe5dbb35374a9a",
            "campaign_id": "668627fc3f30909b2ae9bd61",
            "label": "INTERESTED",
            "is_unread": true,
            "is_starred": false,
            "is_archived": false,
            "has_draft": false,
            "eaccount": "sender@account.com",
            "eaccount_first_name": "Jane",
            "eaccount_last_name": "Smith",
            "latest_message": {
                "id": "66b9d78ff91fabf920f6964d",
                "type": "received",
                "from_address_email": "lead@example.com",
                "from_address_json": [
                    {
                        "address": "lead@example.com",
                        "name": "Jane Doe"
                    }
                ],
                "to_address_email_list": "sender@account.com",
                "to_address_json": [
                    {
                        "address": "lead@example.com",
                        "name": "Jane Doe"
                    }
                ],
                "subject": "RE: Quick question about your outreach process",
                "preview": "Thanks for reaching out! Could you send over some pricing details? Best, Jane",
                "timestamp": "2026-06-22T09:15:32.000Z"
            }
        }
    ]
}

Modified at 2026-08-16 06:21:46

Get all campaigns statistics

Get emails