---
title: "Append rows to a contact list"
method: POST
path: "/v1/contact-lists/{contact_list_id}/contacts"
---

# Append rows to a contact list

`POST /v1/contact-lists/{contact_list_id}/contacts`

## Request

- Base URL: `https://api.skysay.ai`
- URL: `https://api.skysay.ai/v1/contact-lists/{contact_list_id}/contacts`
- Auth: none declared

## Path parameters

- `contact_list_id` string, required

## Request body

- ContactImport
  - `contacts` ContactRow[], required
    - `consent_basis` 'existing_customer' | 'explicit_consent'
    - `external_reference` string
    - `first_name` string: The contact's first name, as supplied (never derived from `name`); no `{` or `}`. Empty clears it. A custom value named `first_name` in `variables` is a separate value.
    - `language` string
    - `name` string
    - `phone_e164` string, required
    - `time_zone` string: IANA time zone such as America/New_York, matched ignoring case. Another spelling of a zone (US/Eastern, Europe/Kiev, EST) is stored as the zone it names; an offset such as UTC-5 is refused. Empty: the number's zone, when the number has only one
    - `variables` object: Flat template variables: the attempt's whole call context, at most 32 keys and 4 KB, lists of at most 16 items; never secrets
  - `organization_id` string, required

## Response `200`

Per-row import report

---

[API](https://skmtc.dev/skysay/apis/skysay-api.md) · [All operations](https://skmtc.dev/skysay/apis/skysay-api/llms.txt) · [OpenAPI document](https://skmtc.dev/skysay/apis/skysay-api/revisions/148c7e111260?raw)