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

# Add Contact to List

`POST /add-to-list.json`

Adds a new contact to a list
If a contact is added that already exists it will be ignored, not updated.

## Response `200`

OK

- object
  - `list_id` integer — Numeric ID of the list that contact was added to.
  - `msisdn` string — Mobile number of contact that was added.
  - `firstname` string — First name of contact added.
  - `lastname` string — Last name of contact added.
  - `created_at` string — Date and time contact was added. Returned in ISO8601 format YYYY-MM-DD HH:MM:SS in UTC Timezone.
  - `status` string — Status of contact. This is always set to active with this request.
  - `fields` object — Values assigned to custom fields.
  - `errors` object
    - `BAD_MOBILE` string — The mobile provided is invalid.
    - `BAD_MOBILE_COUNTRY` string — The country of the mobile provided is unavailable.
    - `OPTOUT` string — The recipient provided was previously opted out.
    - `DUPLICATE_DELETED` string — The recipient provided was previously deleted.
    - `KEY_EXISTS` string — Contact with such mobile already exists.

---

[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)