Apollo icon

Apollo

Interact with Apollo API

List → Create

AI-generated

Summary

Create a new list in Apollo by specifying its name and type (modality).

Inputs

  • Name (required) — Name of the list to create.
  • Modality — Type of the list, either 'Contact' or 'Account', defaulting to 'Contact'.
  • Request Options — Optional settings like batching, SSL handling, proxy, and request timeout.

Output shape

a single record representing the newly created list

The API responds with JSON data of the created list object. The operation expects the 'name' and 'modality' properties sent in the request body to '/api/v1/lists' via POST.

Examples

Example 1: Create a new contact list named 'Prospects'

Set 'Name' to 'Prospects' and 'Modality' to 'Contact' (default). The node sends a POST request to '/api/v1/lists' with body { name: 'Prospects', modality: 'contact' } and returns the created list object.

Links

Discussion