Prosp

List Campaigns

List all campaigns in your Prospect workspace. Returns an array of { campaign_id, campaign_name }.

Get Campaign Status

Get a campaign's current run status (active or not) and name.

Start Campaign

Start a campaign. Fails if archived or deleted. Idempotent — re-calling on an already-active campaign returns 400 "already running" which can be treated as success.

Stop Campaign

Stop a running campaign. Idempotent — re-calling on a non-active campaign is safe; treat any "already stopped" response as success.

Get Campaign Analytics

Get analytics rows for the workspace, optionally filtered to a single campaign and a date range. Returns [{ date, action, description, count }, …]. Defaults to last 7 days.

List Campaign Leads

List leads in a campaign. Returns [{ name, linkedinUrl }, …].

Get Lead Stage

Get the current step name for a specific lead inside a campaign.

Add Lead

Add a LinkedIn profile as a contact AND attach it to a campaign in one call (orchestrates add_contact + add_lead_to_campaign). Idempotent on `linkedin_url` — calling twice with the same URL updates the existing contact rather than duplicating it. `list_id` is required (fetched from list_contact_lists); the upstream contact route hard-rejects without it.

Add Contact

Create or update a workspace contact for a LinkedIn profile. Idempotent on `linkedin_url` — calling twice with the same URL updates the existing contact rather than duplicating it.

Delete Contact

Soft-delete a contact from the workspace.

Add Lead To Campaign

Add an existing contact to a specific campaign.

Remove Lead From Campaign

Soft-delete a lead from a campaign (does not delete the contact).

Get Conversation

Fetch the LinkedIn conversation between the sender's connected account and a lead. Supports both standard inbox and Sales Navigator inbox.

Send Linkedin Message

⚠️ NOT idempotent — do NOT retry on timeout or transport error; verify with `get_conversation` first or you will send a duplicate DM. Send a LinkedIn DM. Sender must already be a first-degree connection of the recipient. Long-running (up to 5 min).

Send Linkedin Voice

⚠️ NOT idempotent — do NOT retry on timeout or transport error; verify with `get_conversation` first or you will send a duplicate voice message. Send a LinkedIn voice message. Provide either `message` (text → TTS via the workspace's trained ElevenLabs voice) OR `link` (URL of an existing mp3) — not both. Long-running (up to 5 min).

List Contact Lists

List all contact lists in your Prospect workspace. Returns [{ id, name, color, count }, …] where `count` is the number of non-deleted contacts attached to each list (single grouped query, no N+1).

Create Contact List

Create a new contact list. `name` is trimmed and must be unique within the workspace (case-insensitive). `color` is optional — if omitted the server picks one from the workspace palette.

Update Contact List

Rename or recolor an existing contact list. At least one of `name` or `color` must be provided. Renames propagate to `workspace_contacts.list_name` so attached contacts stay consistent.

Delete Contact List

Delete a contact list. Safe by default: if the list still has contacts attached you get 409 'list is not empty' with the attached count surfaced in the hint. Re-call with `cascade: true` to soft-delete those contacts (and their `campaign_contacts` rows) in one step. ⚠️ Cascade is destructive — confirm with the user first.

List Senders

List the workspace's connected LinkedIn sender accounts — the LinkedIn profiles authorized to send DMs / voice messages via Prosp. Returns [{ linkedin_url, full_name }, …], filtered to accounts with an active (non-expired) LinkedIn cookie. Use this to resolve the `sender` arg for `get_conversation` / `send_linkedin_message` / `send_linkedin_voice` instead of asking the user.