API
Get API key

Update a List

patch
https://api.apollo.io/api/v1/labels/
✅

No Credit Cost

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

A list 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 Get a List of All Lists endpoint and identify the id value for the list you want to update.

Path Params
string
required

The Apollo ID for the list you want to update.

To find list IDs, call the Get a List of All Lists endpoint and identify the id value.

Example: 6612a4b7c8d9e0f123456789

Body Params
string
required

The new name for the list. Must be unique for the list's modality within your team.

Example: Conference 2024 - Maui (West)

boolean

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

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Updated about 15 hours ago

What’s Next

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
text/plain

Updated about 15 hours ago

What’s Next