lemlist Inbox API
The unified reply inbox - conversations, messages, drafts, labels and sending on email, LinkedIn and WhatsApp.
Operations 15
Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay
Ask an LLM
“Which conversations are waiting in my lemlist unified inbox?”
“Can I page through the inbox for one teammate?”
Tell an agent
List my inbox conversations.
Show page {page} of the inbox for user {userId}, {limit} at a time.
Ask an LLM
“How do I read the full conversation history with one contact?”
“Can I mark a conversation as read when I fetch its messages?”
Tell an agent
Show the messages exchanged with contact {contactId}.
Open the conversation with {contactId} and set markAsRead to {markAsRead}.
Ask an LLM
“How do I send a one-off email reply to a lead from the inbox?”
“Can I CC someone when emailing a contact directly?”
Tell an agent
Email contact {contactId} with subject {subject} and message {message}.
Send lead {leadId} an email saying {message}, CC {cc}, from {sendUserEmail}.
Ask an LLM
“Can I send a LinkedIn DM to a lead through the API?”
“How do I reply to a prospect on LinkedIn from lemlist?”
Tell an agent
Send a LinkedIn message to contact {contactId}: {message}.
Message lead {leadId} on LinkedIn as user {sendUserId} saying {message}.
Ask an LLM
“Is it possible to text a prospect on WhatsApp from lemlist?”
“Which WhatsApp account will my message go out from?”
Tell an agent
Send a WhatsApp message to contact {contactId}: {message}.
WhatsApp lead {leadId} from account {sendUserWhatsappAccountId} saying {message}.
Ask an LLM
“What labels can I use to tag inbox conversations?”
“Which conversation tags has my team already created?”
Tell an agent
List all inbox labels.
Show the labels my team uses for conversations.
Ask an LLM
“How do I add a new label for sorting conversations?”
“Can I create a team-wide tag like 'Hot lead' for the inbox?”
Tell an agent
Create an inbox label called {labelName}.
Add a new conversation label named {labelName} for the team.
Ask an LLM
“What's stored on a particular inbox label?”
“Can I look up a label's name from its id?”
Tell an agent
Show inbox label {labelId}.
Get the name and info of label {labelId}.
POST
/inbox/conversations/labels/{contactId}
Tag a conversation with labels · Attach Labels to Conversations
#
Ask an LLM
“How do I tag a conversation with one or more labels?”
“Can I replace a conversation's existing labels instead of adding to them?”
Tell an agent
Attach labels {labelIds} to the conversation with {contactId}, appendLabels {appendLabels}.
Label conversation {contactId} with {labelIds} on top of its current labels, appendLabels {appendLabels}.
DELETE
/inbox/conversations/labels/{contactId}
Remove labels from a conversation · Remove Labels from Conversation
#
Ask an LLM
“How do I untag a conversation that was labeled by mistake?”
“Can I strip specific labels off one conversation?”
Tell an agent destructive · confirm first
Remove labels {labelIds} from the conversation with {contactId}.
Untag conversation {contactId} of {labelIds}.
Ask an LLM
“Which unsent drafts do I have for a given contact?”
“Can I see the drafts a teammate wrote for a prospect?”
Tell an agent
List drafts for contact {contactId} owned by {draftOwner}.
Show {draftOwner}'s pending drafts to {contactId}.
Ask an LLM
“How do I prepare a draft reply for a contact without sending it?”
“What's the size limit on a draft's content?”
Tell an agent
Draft a {channel} message to {contactId} for {draftOwner}: {content}.
Create an email draft for {contactId} as {draftOwner} with subject {subject}, channel {channel}, body {content}.
Ask an LLM
“Can I read the full text and attachments of a single draft?”
“Where do I open a specific saved draft for a contact?”
Tell an agent
Open draft {draftId} for contact {contactId} owned by {draftOwner}.
Show the content of {draftOwner}'s draft {draftId} to {contactId}.
Ask an LLM
“Can I change the subject or body of a draft I already saved?”
“How do I add a CC to an existing draft?”
Tell an agent
Change the subject of draft {draftId} for {contactId} (owner {draftOwner}) to {subject}.
Rewrite {draftOwner}'s draft {draftId} to {contactId} as {content}.
Ask an LLM
“How do I throw away a draft I don't want to send?”
“Is a deleted draft actually erased or just marked deleted?”
Tell an agent destructive · confirm first
Delete draft {draftId} for contact {contactId} owned by {draftOwner}.
Discard {draftOwner}'s draft {draftId} to {contactId}.