Create a List

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 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 Add Records to a List endpoint.

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.

Body Params
string
required

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

Example: Conference 2024 - Maui

string
enum
required

The type of records the list holds.

  • contacts: a list of contacts (people).
  • accounts: a list of accounts (companies).

Allowed:
boolean

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

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

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