# Circle Realtime WebSocket API

**Canonical:** https://apis.io/apis/circle-community/circle-community-realtime-websocket-api/  
**Provider:** Circle — https://apis.io/providers/circle-community/  
**Base URL:** wss://app.circle.so/cable  
**Documentation:** https://api.circle.so/get-started/websockets-beta

Circle Realtime WebSocket API is one of 8 APIs that [Circle](https://apis.io/providers/circle-community/) publishes on the [APIs.io](https://apis.io/) network, described by an AsyncAPI event-driven specification. Tagged areas include WebSocket, Real-Time, Chat, Notification, and ActionCable. The published artifact set on APIs.io includes API documentation and an AsyncAPI specification.

Beta ActionCable (Rails) WebSocket surface for realtime chat and notifications, connected at wss://app.circle.so/cable with a member Bearer access token and a whitelisted Origin header. Exposes a NotificationChannel (new-notification and unread-count events) and three chat channels for member-level room updates, room-wide messages, and thread events.

## Machine-readable artifacts (3)

- **Documentation** — https://api.circle.so/get-started/websockets-beta
- **AsyncAPI** — https://raw.githubusercontent.com/api-evangelist/circle-community/refs/heads/main/asyncapi/circle-community-asyncapi.yml
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/circle-community/refs/heads/main/apis.yml

## Other Circle APIs (7)

- [Circle Admin - Courses API](https://apis.io/apis/circle-community/circle-community-admin-courses-api/)
- [Circle Admin - Events API](https://apis.io/apis/circle-community/circle-community-admin-events-api/)
- [Circle Admin - Members API](https://apis.io/apis/circle-community/circle-community-admin-members-api/)
- [Circle Admin - Posts API](https://apis.io/apis/circle-community/circle-community-admin-posts-api/)
- [Circle Admin - Spaces API](https://apis.io/apis/circle-community/circle-community-admin-spaces-api/)
- [Circle Headless - Auth API](https://apis.io/apis/circle-community/circle-community-headless-auth-api/)
- [Circle Headless - Member API](https://apis.io/apis/circle-community/circle-community-headless-member-api/)

## Tags

WebSocket, Real-Time, Chat, Notification, ActionCable

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/circle-community/circle-community-realtime-websocket-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/circle-community/.
