Chattr Developer Platform
Chattr apps come in three kinds:
- Webhooks: post messages into one text channel with a URL.
- Integrations: use Bearer tokens to manage server members.
- OAuth apps: identify Chattr users on external sites.
Quick map
- Start with Webhooks if you only need to send messages.
- Use Integrations if you need to sync roles, nicknames, or moderation state.
- Add OAuth if your website needs to know which Chattr account is connected.
Who can create and manage apps
| App type | Who can create | Who can manage |
|---|---|---|
| Webhook | Any member with manage_server permission |
Same — manage_server on that server |
| Integration | Any member with manage_server permission |
Same — manage_server on that server |
| OAuth | Any phone-verified user | Only the app owner |
The manage_server permission is automatically granted to server owners and administrators. It can also be assigned to any custom role.
Security model
- Server-scoped actions are granted explicitly by server managers.
- Third-party OAuth is identity-only.
- Only the first-party Chattr developer portal receives user access tokens.
URLs
- Public OAuth authorization:
/oauth/authorize - OAuth token exchange:
/oauth/token - Runtime webhook posts:
/webhooks/:appId/:token - Management APIs:
/api/apps/*