Create List

Create a named contact list. Lists are reusable collections - use them to organize contacts before enrolling in campaigns.

MCP tool name: create_list

Use Cases

Group imported contacts by industry or territory
Prepare lists of prospects for targeted campaigns
Organize contacts from different CSV exports

Parameters

Name	Type	Required	Description
id	`string`	required	List slug (3-50 chars, lowercase alphanumeric + hyphens)
name	`string`	required	Human-readable list name
description	`string`	optional	Optional list description

Example

Prompt

Create a list called 'senior-clinical-belgium' for Belgian medical leaders

Response

{
  "success": true,
  "list": {
    "id": "senior-clinical-belgium",
    "name": "Senior Clinical Belgium",
    "created_at": "2024-01-15T10:00:00Z"
  }
}

Permission Scopes

This tool is available in the following permission scopes:

full accessoutboundcontent

Related Tools

List Lists

View all your contact lists with member counts. Manage named collections via MCP.

Add to List

Add contacts to a named list by ID or LinkedIn URL. Idempotent - duplicates are ignored.

Import Contacts

Bulk import contacts from Lemlist, Heyreach, Expandi, or any CSV. Auto-maps field names and deduplicates by LinkedIn URL.

Explore all Lists tools

The complete LinkedIn API. Ready when you are.

Connect your first LinkedIn profile in under 5 minutes. All 105 tools. Safe limits, warm-up, and full permission control built in.

Start now Read the docs