---
title: "Changes to Create a List"
method: POST
path: "/api/v1.4/lists/"
---

# Changes to Create a List

`POST /api/v1.4/lists/`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 3 of 5 revisions.

- **2024-12-04** `b36e8e329afb` — 1 breaking, 11 info
- **2024-12-04** `f80fb2a115ff` — 1 breaking, 5 warning, 7 info
- **2024-12-04** `29fbf7a6e106` — 1 warning

## Changes

- **2024-12-04** `b36e8e329afb` — 1 breaking, 11 info
  - the request property `name` became required
  - the endpoint scheme security `ApiKeyAuth` was removed from the API
  - api tag `lists` added
  - added the media type `application/json` for the response with the status `400`
  - added the media type `application/json` for the response with the status `401`
  - added the media type `application/json` for the response with the status `429`
  - added the media type `application/json` for the response with the status `500`
  - the response property `company_count` became required for the status `200`
  - the response property `created_date` became required for the status `200`
  - the response property `list_uid` became required for the status `200`
  - the response property `name` became required for the status `200`
  - the response property `updated_date` became required for the status `200`
- **2024-12-04** `f80fb2a115ff` — 1 breaking, 5 warning, 7 info
  - request body became required
  - deleted the `header` request parameter `Content-Type`
  - removed the optional property `count` from the response with the `200` status
  - removed the optional property `page` from the response with the `200` status
  - removed the optional property `pages` from the response with the `200` status
  - removed the optional property `results` from the response with the `200` status
  - api operation id `create` removed and replaced with `createList`
  - the endpoint scheme security `ApiKeyAuth` was added to the API
  - added the optional property `company_count` to the response with the `200` status
  - added the optional property `created_date` to the response with the `200` status
  - added the optional property `list_uid` to the response with the `200` status
  - added the optional property `name` to the response with the `200` status
  - added the optional property `updated_date` to the response with the `200` status
- **2024-12-04** `29fbf7a6e106` — 1 warning
  - deleted the `header` request parameter `Authorization`

---

[Operation](https://skmtc.dev/tjc-lp/apis/grata-unified-api/docs/api/v1.4/lists/post.md) · [API](https://skmtc.dev/tjc-lp/apis/grata-unified-api.md) · [Page](https://skmtc.dev/tjc-lp/apis/grata-unified-api/changes/api/v1.4/lists/post)