---
name: sms-messenger-pty-ltd-sms
description: Send SMS / text messages, send bulk SMS, check SMS credit balance, list sent messages, and list contacts using the SMS Messenger (Pty) Ltd SMS API. Use this skill whenever the user wants to send a text message, send an SMS, send bulk SMS, broadcast a message to multiple phone numbers, check their SMS credit balance, list contacts, or look up recently sent messages.
---

# SMS Messenger (Pty) Ltd SMS

Send SMS messages via the SMS Messenger (Pty) Ltd REST API at `http://sms1.smsmessenger.co.za/app/api/rest/v1`.

## On first use

Look for credentials at:

- macOS / Linux: `~/.config/sms-messenger-pty-ltd/credentials`
- Windows: `%APPDATA%\sms-messenger-pty-ltd\credentials`

If the file does not exist, ask the user for their SMS Messenger (Pty) Ltd login email and API key, then save them in the format:

```
email=<email>
api_key=<key>
```

On macOS / Linux, set permissions to `0600`. The user can find their API key by signing in to http://sms1.smsmessenger.co.za/app, clicking their company name, then "Developer settings."

## Authentication

On every API request, set the HTTP headers:

```
email: <email>
token: <api-key>
```

## API contract

Fetch `http://sms1.smsmessenger.co.za/app/llms-full.txt` once per session for the full machine-readable API contract. Cache it for the session ? only re-fetch if a request fails with a schema mismatch.

## Error handling

If a request returns 401 Unauthorized, delete the credentials file and prompt the user for new credentials.