Write

Manage Outreach Lists

Create, delete, or list outreach lists with a single action parameter. Use action='create' to spin up a new contacts, companies, or blocklist roster, action='delete' to remove one by slug, and action='list' to return every list with pagination support. Blocklist lists create a managed do-not-contact roster, keeping your segmentation and suppression organized in one place.

manage_listsGET/api/v1/lists

Get started View docs

crispy — bash

Example prompt: Create a new contacts list called 'Senior Clinical Belgium' for my upcoming campaign

{
  "action": "create",
  "list": {
    "id": "senior-clinical-belgium",
    "name": "Senior Clinical Belgium",
    "kind": "contacts",
    "member_count": 0
  }
}

Permission scope

core

Access

Write

What you can build

Spin up a fresh prospect list for each campaign segment before enrolling contacts

Maintain a managed do-not-contact blocklist that outreach automatically respects

Audit every list you have built, including archived ones, in a single paginated view

Clean up stale or finished lists by deleting them once a campaign wraps

Parameters

Inputs accepted by manage_lists.

Name	Type	Required	Description
action	`"create" \| "delete" \| "list"`	required	Action to perform on lists
list_id	`string`	optional	List slug, required for action='delete', used as ID for action='create'
name	`string`	optional	Human-readable list name (for action='create')
description	`string`	optional	Optional list description (for action='create')
kind	`"contacts" \| "companies" \| "blocklist"`	optional	List kind. Default 'contacts'. 'blocklist' creates a managed do-not-contact roster.
include_archived	`boolean`	optional	Include archived lists (for action='list', default: false)
limit	`number`	optional	Max results to return (for action='list')
offset	`number`	optional	Pagination offset (for action='list')

Related tools

Update List Details

Rename a list, edit its description, or archive and unarchive it. Keep your LinkedIn outreach lists organized and current via MCP.

Update List Membership

Add or remove contacts and companies from a list using IDs or LinkedIn URLs. Manage list membership in bulk for targeted outreach via MCP.

List And Export Contacts

Query and export LinkedIn contacts with rich filters by connection status, campaign, tags, or custom attributes. Returns JSON or CSV for bulk export.

Explore all Lists tools

The complete LinkedIn API. Ready when you are.

Connect your first LinkedIn profile in under 5 minutes. Every tool, every seat, no feature gates. Safe limits, warm-up, and full permission control built in.

Start now Read the docs