Call the manageLeadList MCP tool
Manage lead lists post-hoc, in four actions. (1) split_by_open_profile: create a NEW lead list containing only the OPEN PROFILE leads from an existing list (source_list_id + open_list_name), the audience for a free cold-InMail campaign (createDraftCampaign with the inmail_open_profiles preset). Open-profile status is learned only by visiting or enriching a profile - a campaign's visit_profile step, or the InMail-activation list_enrichment job - NOT by scraping or search (LinkedIn stopped exposing it there). Leads that have not yet been visited or enriched, including freshly scraped leads and ones exported from the Reachium database (addSearchToLeadList), start with unknown status and will not match until then. keep defaults to 'open' (only the Open list is created); keep:'both' also creates a second list (other_list_name) with the Remaining, not-confirmed-open leads. (2) merge: combine 2 to 25 existing lists (source_list_ids) into ONE brand-new list (new_list_name), deduped by lead. (3) rename: rename ONE existing list in place (list_id + new_name) - name only, matching the app's own rename dialog exactly, so it does not touch the list's description field. No credits are charged for any of these three actions. split_by_open_profile and merge are additive: their source lists are only ever read, never modified. rename is the one action here that changes an existing list, and it only ever changes that list's name; the LEADS on a renamed list are never touched. (4) enrich_emails: preview, then confirmation-gate, up to 500 blank-email LinkedIn leads from one list through a connected Prospeo or Apollo account. It can spend vendor credits, never Reachium credits; the preview shows eligible/today and the provider balance when available. Run it again tomorrow for any remainder.
Called through the Actions bridge: the response is that tool's own result, wrapped as { data: <tool result> } under HTTP 200. Billing, daily-cap, and confirm-step outcomes are embedded INSIDE data, never remapped to an HTTP status (see the templated /api/v1/actions/{toolName} operation above for the full protocol, and x-mcp-actions for this tool's machine-readable scope/cap/confirm_behavior fields). Authentication, request-shape, and optional idempotency-protocol failures still use their documented non-200 statuses.
Request
- Base URL: https://app.reachium.io
- URL: https://app.reachium.io/api/v1/actions/manageLeadList
- Auth: HTTP bearer
Headers
Optional caller-generated key (8-200 characters: letters, digits, dot, underscore, colon, or hyphen). A final tool result is replayed for the same key and body. An ambiguous result remains 409 under that key; reconcile external state before using a new key. Reuse with a different body returns 422.
Request body
Response
The result of calling this tool.
Changes
No recorded changes to this operation across all 1 revision of this API.