Send SMS from your AI

Install a SMS Messenger (Pty) Ltd skill in your AI agent so it can send SMS, check your credit balance, and look up your contacts on your behalf.

One-line install

Tell your AI agent the following — it will install the skill, ask for your SMS Messenger (Pty) Ltd email and API key, and verify everything works:

install the SMS Messenger (Pty) Ltd SMS skill from http://sms1.smsmessenger.co.za/app/ai/install

Works with Claude Code, OpenAI Codex CLI, Gemini CLI, Aider, Continue, Windsurf, and any other agent that reads AGENTS.md.

▶Manual install (advanced)

If your agent could not follow the one-line install, pick your agent below and follow the instructions.

Save this file as:~/.claude/skills/sms-messenger-pty-ltd-sms/SKILL.md

After saving, restart Claude Code (or open a new conversation) and ask Claude to send an SMS.

---
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.

Save this file as:~/.codex/AGENTS.md (personal scope, recommended) or ./AGENTS.md in your project directory.

If AGENTS.md already exists, append the content below. Compatible with OpenAI Codex CLI, Aider, Continue, Windsurf, and other agents that read AGENTS.md.

# SMS Messenger (Pty) Ltd SMS

This file teaches the agent how to send SMS messages via the SMS Messenger (Pty) Ltd REST API at `http://sms1.smsmessenger.co.za/app/api/rest/v1`.

## When to use this

Use this skill whenever the user wants to:

- Send an SMS or text message
- Send bulk SMS to multiple recipients
- Check their SMS Messenger (Pty) Ltd SMS credit balance
- List recently sent messages
- List their contacts

## 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.

Save this file as:~/.gemini/GEMINI.md

After saving, restart Gemini CLI (or start a new chat) and ask it to send an SMS.

# SMS Messenger (Pty) Ltd SMS

This file teaches Gemini how to send SMS messages via the SMS Messenger (Pty) Ltd REST API at `http://sms1.smsmessenger.co.za/app/api/rest/v1`.

## When to use this

Use this skill whenever the user wants to:

- Send an SMS or text message
- Send bulk SMS to multiple recipients
- Check their SMS Messenger (Pty) Ltd SMS credit balance
- List recently sent messages
- List their contacts

## 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.

REST API getting started Interactive API Code snippets