list

Mailing lists organize prospects for campaign targeting. Create lists to group contacts, then add them to campaigns.

No bulk list re-assignment. baseListId is only the prospect's primary-list pointer, not list membership — set it one prospect at a time with prospect/patch_by_id, pacing the loop (60 requests/min per API key, shared across every operation — call-contract). List membership — what includeListIds and campaign targeting see — is a subscription, added in bulk (listId, ≤100 rows) with prospect/post_bulk.

Operations

Read

• list/get — Retrieve all mailing lists
• list/get_by_id — Retrieve a mailing list by ID

Create

• list/post — Create a new mailing list

Update

• list/patch_by_id — Update a list's title or folder

Delete

• list/delete_by_id — Delete a list
• list/delete_by_id_prospects_by_prospectId — Remove a prospect from a list