---
title: "Create a List"
method: POST
path: "/labels"
tags: ["Miscellaneous"]
---

# Create a List

`POST /labels`

This endpoint doesn't consume Apollo credits. Learn more about [API pricing and credits](https://docs.apollo.io/docs/api-pricing).

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.<br><br>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>.<br><br>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.

## Request body

- object
  - `name` string, required — The name for the new list. Must be unique for the given `modality` within your team.<br><br>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_business` 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`.

## Response `200`

200

- object
  - `label` object
    - `id` string
    - `modality` string
    - `cached_count` integer
    - `name` string
    - `created_at` string
    - `updated_at` string
    - `user_id` string
    - `book_of_business` boolean, nullable

## Other responses

- `401` — 401
- `403` — 403
- `422` — 422
- `429` — 429

---

[API](https://skmtc.dev/apollo/apis/apollo-rest-api.md) · [All operations](https://skmtc.dev/apollo/apis/apollo-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/apollo/apollo-rest-api/revisions/c715a05fa6e2/schema)