POST JSON to a signed URL — message lands in the target channel.
POST /webhooks/:appId/:token
Developer platform
Connect your services to Chattr.
Three tools: a webhook posts messages to a channel, an integration manages server members, OAuth lets your site identify a user's Chattr account.
WebhooksIntegrationsOAuth
Manages server roles and members via an issued token.
Authorization: Bearer <token>
Identity only — returns user ID, nickname, name, and avatar URL.
GET /oauth/authorize POST /oauth/token
Webhooks
Post messages to a channel
Create a webhook, pick a channel, and get a URL. POST a message to it and it appears in the channel. One URL, one channel.
- Bound to a server and channel at creation
- URL can be rotated at any time
- No auth headers needed — token is in the URL
POST /webhooks/:appId/:token
{"content":"Hello!"}Webhook docs →Integrations
Manage server members
Connect an external system that can manage member roles, nicknames, and status on your server. Tokens are server-scoped and shown once at creation.
- Manage roles, nicknames, and moderation
- Multiple named tokens per app
- Each token can be revoked at any time
Authorization: Bearer <token>Integration docs →
OAuth
Identify accounts
Redirect users to a Chattr sign-in page and receive their ID, name, and avatar. OAuth apps get identity only — no management access.
- Standard authorization code flow
- Redirect URI configured per app
- The Chattr developer portal gets extended access
GET /oauth/authorize POST /oauth/tokenOAuth docs →