Write

Update List Details

Update a list's name, description, or archived status by list ID. Set archived to true to retire a finished list or false to bring it back into rotation, and pass a new name or description to keep it current. Returns a not found error if the supplied list ID does not exist.

update_listPATCH/api/v1/lists/{list_id}

Get started View docs

crispy — bash

Example prompt: Rename the 'senior-clinical-belgium' list to 'Senior Clinical Belux' and update its description

{
  "id": "senior-clinical-belgium",
  "name": "Senior Clinical Belux",
  "description": "Senior clinical leads in Belgium and Luxembourg",
  "archived": false
}

Permission scope

core

Access

Write

What you can build

Rename a list as a campaign focus or segment definition evolves

Archive a completed list to declutter your workspace without losing it

Unarchive a past list to reuse its segment for a new campaign

Refine a list description so teammates understand its purpose

Parameters

Inputs accepted by update_list.

Name	Type	Required	Description
list_id	`string`	required	The list ID to update
name	`string`	optional	New list name
description	`string`	optional	New list description
archived	`boolean`	optional	Set to true to archive, false to unarchive

Related tools

Manage Outreach Lists

Create, delete, and list outreach lists for contacts, companies, or do-not-contact rosters. Organize your LinkedIn outreach by segment 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 Contact Lists

List all your contact lists with member counts. Deprecated in favor of manage_lists with action='list' for full list management via MCP.

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.

Connect your first profile

Read the docs