TalkToPlanB Developer Portal

Developer Sign In

Sign in with the TalkToPlanB account your bot will act as.

No developer account yet? Create one

Create Developer Account

This becomes the account your bot acts as. We'll email a verification code.

Enter the 6-digit code sent to

Already have an account? Sign in

Create a new API key

🔑 Copy this key now — it will not be shown again.

Your API keys

API Documentation

Base URL: https://talktoplanb.duckdns.org

Authenticate every request with the X-API-Key header. Rate limit: 60 requests/minute.

📘 Interactive API docs (Swagger UI)  ·  🤖 OpenAPI spec (for AI agents & codegen)

Send a message

curl -X POST https://talktoplanb.duckdns.org/api/v1/messages \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"toPhone":"+60123456789","text":"Hello!"}'

Read messages

curl "https://talktoplanb.duckdns.org/api/v1/messages?roomId=ROOM_ID" \
  -H "X-API-Key: YOUR_KEY"

List rooms

curl https://talktoplanb.duckdns.org/api/v1/rooms -H "X-API-Key: YOUR_KEY"

Webhook payload (incoming messages)

{ "event": "message.received",
  "data": { "id", "roomId", "content", "senderId", "senderName", "createdAt" } }