kudosity-smslisted
Install: claude install-skill kudosity/skills
# Send SMS Messages
Kudosity supports two ways to send SMS depending on the use case:
- **Single recipient** → V2 API (simpler, JSON-based)
- **List-based send / multiple recipients** → V1 API (supports list_id and comma-separated numbers)
## Authentication
**V2 API** (single recipient):
- Header: `x-api-key: {KUDOSITY_API_KEY}`
**V1 API** (list-based or multi-recipient):
- Header: `Authorization: Basic {base64(KUDOSITY_API_KEY:KUDOSITY_API_SECRET)}`
Credentials come from the Kudosity dashboard under **Developers → API Settings**. Set `KUDOSITY_API_KEY` (and `KUDOSITY_API_SECRET`, which the V1 API needs) in the environment before calling.
## Option A: Send to a Single Recipient (V2 API)
**Endpoint**: `POST https://api.transmitmessage.com/v2/sms`
**Content-Type**: `application/json`
All API calls use `curl` commands.
Required parameters:
- `message` (string): The SMS body text
- `sender` (string): The sender number (must be assigned to the account) or alphanumeric sender ID (max 11 chars)
- `recipient` (string): Destination number (local or E.164 international format)
Optional parameters:
- `message_ref` (string, max 500 chars): Your reference ID, returned in webhooks
- `track_links` (boolean): Enable link tracking with shortened URLs
Example curl command:
```bash
curl -s -X POST "https://api.transmitmessage.com/v2/sms" \
-H "x-api-key: ${KUDOSITY_API_KEY}" \
-H "User-Agent: kudosity-skills/0.2.1" \
-H "Content-Type: application/json" \
-d '{"message": "Your