# Twilio Sms

> Send and manage SMS messages via the Twilio API.

- Skill: `qhkm/twilio-sms` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add qhkm/twilio-sms`
- Raw SKILL.md: https://api.skillmd.com/api/skills/qhkm/twilio-sms/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- License: MIT
- Author: qhkm (https://skillmd.com/u/qhkm)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/qhkm/twilio-sms

---


# Twilio SMS Skill

Send, check, and list SMS messages using the Twilio API.

## Setup

1. Go to [twilio.com/console](https://www.twilio.com/console)
2. Copy **Account SID** and **Auth Token**
3. Buy or use a trial phone number

```bash
export TWILIO_ACCOUNT_SID="ACxxx..."
export TWILIO_AUTH_TOKEN="xxx..."
export TWILIO_FROM_NUMBER="+1234567890"
```

## Send an SMS

```bash
curl -s -X POST "https://api.twilio.com/2010-04-01/Accounts/$TWILIO_ACCOUNT_SID/Messages.json" \
  -u "$TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN" \
  -d "From=$TWILIO_FROM_NUMBER" \
  -d "To=+60123456789" \
  -d "Body=Hello from ZeptoClaw!" \
  | jq '{sid, status, to, body}'
```

## Check Message Status

```bash
MSG_SID="SMxxx..."
curl -s "https://api.twilio.com/2010-04-01/Accounts/$TWILIO_ACCOUNT_SID/Messages/$MSG_SID.json" \
  -u "$TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN" \
  | jq '{sid, status, to, dateSent: .date_sent, errorCode: .error_code}'
```

## List Recent Messages

```bash
curl -s "https://api.twilio.com/2010-04-01/Accounts/$TWILIO_ACCOUNT_SID/Messages.json?PageSize=10" \
  -u "$TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN" \
  | jq '.messages[] | {sid, from, to, body, status, date_sent}'
```

## Tips

- Phone numbers must be E.164 format: `+[country code][number]`
- Malaysia country code: `+60` (e.g. `+60123456789`)
- Trial accounts can only send to verified numbers
- Status values: `queued`, `sent`, `delivered`, `failed`, `undelivered`
- Rate limit: 1 message/second per number (higher with toll-free/short codes)
- Uses Basic Auth (`-u SID:token`) not Bearer tokens