Introduction

The Chesly API lets you read and send messages, manage your connected accounts, and build automations on top of every chat you connect to Chesly — WhatsApp, Telegram, Discord, Instagram, Messenger, Signal, Slack, Google Chat, Google Messages, X (Twitter), and LinkedIn — from a single set of endpoints.

Plus only. Personal API tokens require an active Chesly Plus subscription. If your subscription lapses, every issued token is rejected on its next request — there is no grace window.

Get a token

Open the Chesly app on iOS.
Go to Settings → Developer → API Tokens.
Tap Create token, give it a memorable label, and choose an expiry (or no expiry).
Copy the token. You can re-reveal it later from the same screen using Face ID, Touch ID, or your device passcode.

Make your first request

Once you have a token, every request is just a standard HTTPS call with an Authorization header:

curl https://api.chesly.app/api/rooms \
  -H "Authorization: Bearer csk_your_token_here"

What's next

Authentication — token format, headers, and revocation.
Rate Limits — what to expect and how to handle 429s.
Examples — common recipes in curl, JavaScript, and Python.
API Reference — the full machine- readable spec.