v1

latestOpenAPI 3.1.02026-07-247601.0 MB

Miscellaneous

Update a List

This endpoint doesn't consume Apollo credits. Learn more about API pricing and credits.

A <a href="https://knowledge.apollo.io/hc/en-us/articles/4409728608525-Create-and-Use-a-List" target="_blank">list</a> is a saved group of contacts or accounts in Apollo that you can organize, action, and track together. Use the Update a List endpoint to rename an existing list or to toggle its Book of Business status. You can't change a list's modality after it's created. To find list IDs, call the <a href="https://docs.apollo.io/reference/get-a-list-of-all-lists">Get a List of All Lists endpoint</a> and identify the id value for the list you want to update.

patch/labels/{id}

Path parameters

idstring required

The Apollo ID for the list you want to update. To find list IDs, call the <a href="https://docs.apollo.io/reference/get-a-list-of-all-lists">Get a List of All Lists endpoint</a> and identify the id value. Example: 6612a4b7c8d9e0f123456789

Request body

namestring required

The new name for the list. Must be unique for the list's modality within your team. Example: Conference 2024 - Maui (West)

book_of_businessboolean

Set to true to mark an account list as a Book of Business (BoB) list. Only applies to account lists.

Response

200