SalesTouch Docs
All MCP tools
Read onlyEmail

Email conversations

email_conversations

List and search email conversations with leads across the mailboxes you can read, newest first. Filter by needs_reply (the lead wrote last), awaiting_reply, mailbox, date, or text in subjects, bodies, senders and lead names.

When to use it

Find the email conversations that need an answer, or search past emails with leads, across all your mailboxes.

Required scopes
email:accesssalestouch:use
Execution
Synchronous MCP tool call

Requirements

Connect at least one mailbox; only conversations with leads are stored.

Example

Ask your agent

Which leads replied to my emails and still need an answer?

Tool arguments
{
  "status": "needs_reply",
  "limit": 20
}
MCP response envelope
{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"data\": { ... },\n  \"meta\": null\n}"
    }
  ],
  "isError": false
}

Expected: Conversations newest first with the lead, mailbox, needs_reply flag, message count and a snippet of the last message, plus next_cursor.

Parameters

query
string

Text matched against subjects, message bodies, senders, lead names and lead email addresses.

status
string

all (default), needs_reply (the lead wrote last) or awaiting_reply (you wrote last).

account_id
string

Mailbox id or address returned by email_accounts. Defaults to every mailbox you can read.

since
string

Only conversations with activity since this ISO 8601 date.

limit
integer

Maximum conversations to return. Defaults to 20.

cursor
string

next_cursor returned by the previous page, reused with the same filters.

Aliases are shown independently because MCP clients send a flat JSON object. Use one alias from each required group, not every alias.

Common errors

insufficient_scope

Reconnect the MCP and approve the requested LinkedIn permission.

paid_plan_required

Use a SalesTouch workspace with LinkedIn MCP access.

trial_payment_method_required

Add a payment method in SalesTouch billing to activate the trial and LinkedIn MCP access.

EMAIL_ACCOUNT_NOT_FOUND

Use a mailbox id or address returned by email_accounts.

INVALID_CURSOR

Restart without cursor, or reuse next_cursor exactly as returned.

On this page

When to use itRequirementsExampleParametersCommon errorsRelated tools