List inbox conversations
Your Unified Inbox: replies to your cold emails plus LinkedIn, Instagram and WhatsApp chats, newest first, in one feed. Each row says who the conversation is with, what was last said and by whom, whether it needs a reply, the campaign it came from and the mailbox or account on your side. Filter to one channel, to conversations that need a reply, to unread ones, by status, sentiment, campaign, mailbox, connected account or prospect, or search by name, address, company, subject and last message. Cursor paginated. Reading never spends any sending limit.
Required scope: campaigns:read.
Returns a cursor-paginated list — pass cursor from the previous page to continue.
needs_reply is true when the contact wrote last and the conversation is open — closing it, snoozing it, or labelling it out-of-office or spam clears it; a new message from the contact brings it back.
last_message_from is "them" or "you", so an agent can tell a reply from its own send without reading the thread.
Chats older than 30 days are listed only when you search; email threads have no such window.
Reading the inbox never marks anything as read and never spends a LinkedIn, Instagram, WhatsApp or email sending limit.
Request
- Base URL: https://warmysender.com/api/v1
- URL: https://warmysender.com/api/v1/inbox/conversations
- Auth: HTTP bearer
Query parameters
Which channel to list; all merges every channel by recency.
Only conversations where the contact wrote last and nothing is closed, snoozed, out-of-office or spam.
Only unread conversations.
email: open | closed | snoozed. Chats: active | archived | spam.
Email only.
Matches the person's name, email / handle / phone, company, the subject and the last message.
Email only.
Email only.
Conversations with this prospect on any channel.
Only chats on this connected LinkedIn account.
Only chats on this connected Instagram account.
Only chats on this connected WhatsApp number.
Results per page (1–200).
next_cursor from the previous page, passed back unchanged.
Response
Success
Changes
No recorded changes to this operation across all 1 revision of this API.