v1

latestOpenAPI 3.1.02026-07-247601.0 MB

Miscellaneous

Create 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 Create a List endpoint to create a new, empty contact or account list in your team's Apollo account. After you create a list, add records to it with the <a href="https://docs.apollo.io/reference/add-records-to-a-list">Add Records to a List endpoint</a>. List names must be unique for each modality within your team. If you try to create a list with a name that already exists for the same modality, Apollo returns a 422 response.

post/labels

Request body

namestring required

The name for the new list. Must be unique for the given modality within your team. Example: Conference 2024 - Maui

modality'contacts' | 'accounts' required

The type of records the list holds. <ul><li>contacts: a list of contacts (people).</li><li>accounts: a list of accounts (companies).</li></ul>

book_of_businessboolean

Set to true to mark an account list as a Book of Business (BoB) list. Only applies when modality is accounts. Defaults to false.

Response

200