commune-sms

Skill: Commune SMS

What I Can Do

I give you a real phone number and let you send and receive SMS messages programmatically via the Commune API. You can send texts to any number, read conversation threads, and list all your SMS conversations — all from within your OpenClaw agent.

Authentication

Requires COMMUNE_API_KEY environment variable. Get one at commune.email.

Base URL: https://api.commune.email
Auth header: Authorization: Bearer $COMMUNE_API_KEY
Content-Type: application/json

My Phone Number

COMMUNE_PHONE_NUMBER — set this environment variable to your full phone number after provisioning (e.g. +14155551234). Also set COMMUNE_PHONE_ID to the phone number's ID string.

---

Core Operations

List Phone Numbers

GET /v1/phone-numbers

Response:

[
  {
    "id": "pn_xxx",
    "number": "+14155551234",
    "label": "Support Line",
    "capabilities": ["sms"]
  }
]

Use this to discover your available phone numbers and their IDs. Save the relevant id as COMMUNE_PHONE_ID.

---

Send SMS

POST /v1/sms/send
Body: {
  "to": "+14155559876",
  "body": "Your meeting is at 3pm today.",
  "phone_number_id": "pn_xxx"
}

Response includes message_id for confirmation.

Number format: Always use E.164 format (+1XXXXXXXXXX for US numbers). If the user gives a 10-digit number, prepend +1.

---

List SMS Conversations

GET /v1/sms/conversations?phone_number_id=PHONE_ID

Response:

[
  {
    "contact_number": "+14155559876",
    "last_message": "Thanks, see you then!",
    "last_message_at": "2026-02-28T09:30:00Z",
    "message_count": 5,
    "direction": "inbound"
  }
]

direction: "inbound" means the last message came from the other person — this conversation may need a reply.

---

Read SMS Conversation with a Specific Number

GET /v1/sms/conversations/:number

Where :number is the contact's phone number in E.164 format (URL-encoded: %2B14155559876).

Response:

[
  {
    "id": "sms_xxx",
    "direction": "inbound",
    "body": "Can we reschedule to 3pm?",
    "from": "+14155559876",
    "to": "+14155551234",
    "created_at": "2026-02-28T09:00:00Z"
  },
  {
    "id": "sms_yyy",
    "direction": "outbound",
    "body": "Sure, 3pm works!",
    "from": "+14155551234",
    "to": "+14155559876",
    "created_at": "2026-02-28T09:05:00Z"
  }
]