---
title: "Create List"
method: POST
path: "/v3/lists"
tags: ["Lists"]
---

# Create List

`POST /v3/lists`

.

## Query parameters

- `trackLastActivity` boolean
- `name` string
- `key` string
- `usesAutoColumns` boolean
- `caseSensitive` boolean
- `usesGeneratedData` boolean

## Request body

- string

## Response `201`

Accepted the request to create the list

- ListResponse
  - `meta` MetadataDTO
    - `timestamp` integer, required — Transaction's date in timestamp
    - `transactionId` string, required — Id for the current transaction (Endpoint's call)
    - `explain` string — Explain string in case of failure
  - `data` ListDTO — lists of owner
    - `id` integer, required — list id
    - `columns` Column[], required — list's columns
      - `name` string, required
      - `type` 'STRING' | 'NUMBER' | 'DATE' | 'BOOLEAN' | 'OBJECT', required
      - `defaultValue` string
      - `indexed` boolean
      - `required` boolean
      - `unique` boolean
      - `customConfiguration` object
    - `name` string, required — list's name
    - `userName` string, required — list's owner
    - `size` integer, required — list's size
    - `key` string, required — list's key
    - `autoId` boolean, required — Whether list uses or not an autogenerated key
    - `usesAutoColumns` boolean, required — Whether list uses or not an autogenerated default columns
    - `caseSensitive` boolean, required — Whether list uses or not case sensitive attribute for its columns's name
    - `usesGeneratedData` boolean, required — Whether list uses or not an autogenerated dummy data to fill unique columns with not data
    - `lastUpdated` string, date-time, required — last updated date in UTC
    - `createdAt` string, date-time, required — created updated date in UTC
    - `tags` string[], required — list's tags
    - `status` 'UPLOADING' | 'CREATED' | 'UPDATING' | 'OK' | 'FAILED_UPDATE', required — list's status
    - `totalLines` integer, required — Total lines read from last file used, if used, for adding users
    - `percentProcessed` integer, required — list's percentage when being created for first time with contacts
    - `listConfiguration` object, required — list's metadata

## Other responses

- `400` — Bad request
- `500` — Internal server error

---

[API](https://skmtc.dev/messangi/apis/raven.md) · [All operations](https://skmtc.dev/messangi/apis/raven/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/messangi/raven/revisions/c87f398fa338/schema)