kudosity-contacts-listslisted

# Contact Lists & Contacts Lists are how you send to many recipients at once. All list and contact operations are on the **V1 API**. ## Authentication V1 uses **HTTP Basic**, not the `x-api-key` header the V2 endpoints use: - Header: `Authorization: Basic {base64(KUDOSITY_API_KEY:KUDOSITY_API_SECRET)}` — `curl -u` does this for you - **Both** `KUDOSITY_API_KEY` and `KUDOSITY_API_SECRET` are required. V1 will not accept the key alone. - Credentials come from the Kudosity dashboard under **Developers → API Settings** - **Base URL**: `https://api.transmitsms.com` - **Content-Type**: `application/x-www-form-urlencoded` — form fields, not JSON ## Create a list **Endpoint:** `POST /add-list.json` - `name` (string, required) — a unique name for the list - `field_1` … `field_10` (optional) — custom field names. `firstname` and `lastname` exist by default. ```bash curl -s -X POST "https://api.transmitsms.com/add-list.json" \ -u "${KUDOSITY_API_KEY}:${KUDOSITY_API_SECRET}" \ -H "User-Agent: kudosity-skills/0.2.1" \ -d "name=My Campaign List&field_1=email&field_2=postcode" ``` The response returns the list `id`. Keep it — everything below needs it. ## Add one contact **Endpoint:** `POST /add-to-list.json` - `list_id` (integer, required) - `msisdn` (string, required) — E.164 international format - `countrycode` (optional) — 2-letter ISO code; auto-formats local numbers - `first_name`, `last_name`, `field_1` … `field_10` (optional) ```bash curl -s -X POST "https://api.