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, from a single set of endpoints. That includes WhatsApp, Telegram, Discord, Instagram, Messenger, Signal, Slack, Google Chat, Google Messages, X (Twitter), LinkedIn, and Reddit.
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.
Readable personal-token access
Use only Authorization: Bearer csk_.... Room names and message text are readable through the documented endpoints. No private key, signed header, or separate bootstrap is required. Use the MatrixroomId returned by room listing for lookup, history and sending.
NO_SIGNING_KEY means you need to sign in again in Chesly to restore your account key. For a room-binding error, open the conversation in Chesly. Never send private keys to the API.