Creating and managing contact lists

Lists are how you group contacts for campaigns, imports, and tracking. One tool manages the list lifecycle and one manages membership.

Creating, listing, deleting

Use 'manage_lists':

• action 'create' with a name creates a list. Pass a list_id slug to control the ID, otherwise one is generated.
• action 'list' returns all your lists. Set include_archived to true to see archived ones too.
• action 'delete' removes a list by list_id.

Lists have a kind: 'contacts' (default), 'companies' for company lists, or 'blocklist' for a managed do-not-contact roster.

Use 'update_list' to rename a list, change its description, or archive and unarchive it without deleting anything.

Adding and removing members

Use 'update_list_membership' with action 'add' or 'remove':

• Contact lists: pass contact_ids (UUIDs) or linkedin_urls. URLs are resolved to existing contacts in your CRM.
• Company lists: pass company_ids or linkedin_company_ids.

Cross-kind mismatches return a clear error, so you cannot accidentally push companies into a contact list.

Filling a list fast

Two shortcuts:

1. 'import_contacts' with a list_id imports and adds to the list in one call. See the importing article for the details.
2. 'upsert_campaign' accepts a list_id directly, so a list can go straight from creation to powering a campaign.

View members anytime with 'list_contacts' filtered by the list.