---
title: "Changes to Create customer lists"
method: POST
path: "/ad_accounts/{ad_account_id}/customer_lists"
---

# Changes to Create customer lists

`POST /ad_accounts/{ad_account_id}/customer_lists`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 4 of 29 revisions.

- **2026-06-04** (v5) `b698c180678a`: 2 breaking, 28 info
- **2025-04-04** (v5) `10f9eba4ad97`: 1 warning
- **2022-11-14** (v5) `e041d7b0cef0`: 1 breaking
- **2022-09-07** (v5) `bd20b6eb152f`: 1 info

## Changes

- **2026-06-04** (v5) `b698c180678a`: 2 breaking, 28 info
  - the `list_type` request property type changed from `string` to no type
  - the `status` response's property type changed from `string` to no type for status `200`
  - added the new optional request property `is_nca`
  - added the new optional request property `records_v2`
  - the request property `records` became optional
  - added the non-success response with the status `400`
  - added the non-success response with the status `401`
  - added the non-success response with the status `403`
  - added the non-success response with the status `404`
  - added the non-success response with the status `429`
  - added the optional property `is_nca` to the response with the `200` status
  - the response optional property `ad_account_id` became read-only for the status `200`
  - the response optional property `created_time` became read-only for the status `200`
  - the response optional property `exceptions` became read-only for the status `200`
  - the response optional property `id` became read-only for the status `200`
  - the response optional property `num_batches` became read-only for the status `200`
  - the response optional property `num_removed_user_records` became read-only for the status `200`
  - the response optional property `num_uploaded_user_records` became read-only for the status `200`
  - the response optional property `status` became read-only for the status `200`
  - the response optional property `type` became read-only for the status `200`
  - the response optional property `updated_time` became read-only for the status `200`
  - added `#/components/schemas/CustomerListStatus` to the `status` response property `allOf` list for the response status `200`
  - the response property `id` became required for the status `200`
  - the response property `name` became required for the status `200`
  - removed the `PROCESSING` enum value from the `status` response property for the response status `200`
  - removed the `READY` enum value from the `status` response property for the response status `200`
  - removed the `TOO_SMALL` enum value from the `status` response property for the response status `200`
  - removed the `UPLOADING` enum value from the `status` response property for the response status `200`
  - the `id` response's property pattern `^\d+$` was added for the status `200`
  - added the success response with the status `201`
- **2025-04-04** (v5) `10f9eba4ad97`: 1 warning
  - removed the request property `exceptions`
- **2022-11-14** (v5) `e041d7b0cef0`: 1 breaking
  - for the `path` request parameter `ad_account_id`, the maxLength was decreased from `19` to `18`
- **2022-09-07** (v5) `bd20b6eb152f`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/pinterest/apis/pinterest-rest-api/docs/ad_accounts/:ad_account_id/customer_lists/post.md) - [API](https://skmtc.dev/pinterest/apis/pinterest-rest-api.md) - [Page](https://skmtc.dev/pinterest/apis/pinterest-rest-api/changes/ad_accounts/:ad_account_id/customer_lists/post)