---
title: "Add List"
method: POST
path: "/add-list.json"
tags: ["Contacts & Lists"]
---

# Add List

`POST /add-list.json`

Create New Contact List

## Response `200`

Successful response

- object
  - `id` string — A unique identifier for the list.
  - `name` string — Custom field name. Firstname and lastname are created by default. There can be up to 10 extra custom fields. 'n' is an integer between 1 and 10.
  - `created` string, date-time — Date and time list was created. Returned in ISO8601 format YYYY-MM-DD HH:MM:SS in UTC Timezone.
  - `members_active` integer — Number of active members in the list. Always returns 0 for a new list.
  - `fields` string[] — Names of created custom fields.
  - `errors` object[]
    - `CODE` string — Error code.
    - `HEADER` integer — HTTP status code.
    - `DESCRIPTION` string — Description of the error.

---

[API](https://skmtc.net/kudosity/apis/transmit-sms-api.md) · [All operations](https://skmtc.net/kudosity/apis/transmit-sms-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kudosity/transmit-sms-api/versions/9f6c34b849af/schema)