aid: circle-community
url: https://raw.githubusercontent.com/api-evangelist/circle-community/refs/heads/main/apis.yml
name: Circle
kind: company
description: >-
  Circle (circle.so) is an all-in-one community platform for creators, coaches,
  and brands - hosting discussions, courses, events, live streams, memberships,
  paywalls, and chat under a single branded space. This is the community
  software company at circle.so, NOT the USDC / stablecoin financial-services
  company. Circle exposes a documented public developer platform: an
  admin-authenticated Admin API (V2) for automations, migrations, and bulk
  administration; a Headless offering (Member API plus Auth API) for embedding
  Circle features into your own website or app via member-scoped JWT tokens; and
  a beta ActionCable WebSocket surface for realtime chat and notifications. API
  access is plan-gated to the Business plan and above.
deliveryModel:
  model: saas
  open_source: false
  commercial: true
  callable_host: true
  label: Hosted service · you call their endpoint
  confidence: high
  source:
  - openapi
  - pricing
  generated: '2026-08-28'
  method: derived
accessModel:
  pricing: paid
  onboarding: unknown
  trial: false
  try_now: false
  public: false
  label: Paid
  confidence: medium
  source:
  - plans
  - authentication
  - security
  generated: '2026-09-03'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/circle-community.png
x-docs-platform: gitbook
x-docs-platform-confidence: high
x-docs-platform-checked: 2026-09-21
tags:
- Community
- Creators
- Courses
- Membership
- Event
- Chat
- Community Platform
- Real-Time
tags_raw:
- Community
- Creators
- Courses
- Memberships
- Events
- Chat
- Community Platform
- Real-Time
created: '2026-07-05'
modified: '2026-10-06'
specificationVersion: '0.23'
apis:
- aid: circle-community:circle-community-realtime-websocket-api
  name: Circle Realtime WebSocket API
  tags:
  - WebSocket
  - Real-Time
  - Chat
  - Notification
  - ActionCable
  tags_raw:
  - WebSocket
  - Realtime
  - Chat
  - Notifications
  - ActionCable
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  humanURL: https://api.circle.so/get-started/websockets-beta
  baseURL: wss://app.circle.so/cable
  properties:
  - url: https://api.circle.so/get-started/websockets-beta
    type: Documentation
  - url: asyncapi/circle-community-asyncapi.yml
    type: AsyncAPI
  description: >-
    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.
- aid: circle-community:circle-community-admin-courses-api
  name: Circle Admin - Courses API
  description: Course sections, lessons, and progress.
  humanURL: https://api.circle.so/apis/admin-api
  baseURL: https://app.circle.so/api/admin/v2
  tags:
  - Admin - Courses
  properties:
  - type: OpenAPI
    url: openapi/circle-community-admin-courses-api-openapi.yml
  - type: Documentation
    url: https://api.circle.so/apis/admin-api
  - type: APIReference
    url: https://api-headless.circle.so/?urls.primaryName=Admin+API+V2
  - type: PostmanCollection
    url: collections/circle-community.postman_collection.json
  - type: OpenCollection
    url: collections/circle-community.opencollection.json
  - type: Documentation
    url: https://api.circle.so/apis/headless
  - type: APIReference
    url: https://api-headless.circle.so/?urls.primaryName=Member+APIs
  - type: Documentation
    url: https://api.circle.so/apis/headless/quick-start
  - type: APIReference
    url: https://api-headless.circle.so/?urls.primaryName=Auth+APIs
- aid: circle-community:circle-community-admin-events-api
  name: Circle Admin - Events API
  description: Events and event attendees.
  humanURL: https://api.circle.so/apis/admin-api
  baseURL: https://app.circle.so/api/admin/v2
  tags:
  - Admin - Events
  properties:
  - type: OpenAPI
    url: openapi/circle-community-admin-events-api-openapi.yml
  - type: Documentation
    url: https://api.circle.so/apis/admin-api
  - type: APIReference
    url: https://api-headless.circle.so/?urls.primaryName=Admin+API+V2
  - type: PostmanCollection
    url: collections/circle-community.postman_collection.json
  - type: OpenCollection
    url: collections/circle-community.opencollection.json
  - type: Documentation
    url: https://api.circle.so/apis/headless
  - type: APIReference
    url: https://api-headless.circle.so/?urls.primaryName=Member+APIs
  - type: Documentation
    url: https://api.circle.so/apis/headless/quick-start
  - type: APIReference
    url: https://api-headless.circle.so/?urls.primaryName=Auth+APIs
- aid: circle-community:circle-community-admin-members-api
  name: Circle Admin - Members API
  description: Admin-authenticated community member management.
  humanURL: https://api.circle.so/apis/admin-api
  baseURL: https://app.circle.so/api/admin/v2
  tags:
  - Admin - Members
  properties:
  - type: OpenAPI
    url: openapi/circle-community-admin-members-api-openapi.yml
  - type: Documentation
    url: https://api.circle.so/apis/admin-api
  - type: APIReference
    url: https://api-headless.circle.so/?urls.primaryName=Admin+API+V2
  - type: PostmanCollection
    url: collections/circle-community.postman_collection.json
  - type: OpenCollection
    url: collections/circle-community.opencollection.json
  - type: Documentation
    url: https://api.circle.so/apis/headless
  - type: APIReference
    url: https://api-headless.circle.so/?urls.primaryName=Member+APIs
  - type: Documentation
    url: https://api.circle.so/apis/headless/quick-start
  - type: APIReference
    url: https://api-headless.circle.so/?urls.primaryName=Auth+APIs
- aid: circle-community:circle-community-admin-posts-api
  name: Circle Admin - Posts API
  description: Posts, comments, and topics.
  humanURL: https://api.circle.so/apis/admin-api
  baseURL: https://app.circle.so/api/admin/v2
  tags:
  - Admin - Posts
  properties:
  - type: OpenAPI
    url: openapi/circle-community-admin-posts-api-openapi.yml
  - type: Documentation
    url: https://api.circle.so/apis/admin-api
  - type: APIReference
    url: https://api-headless.circle.so/?urls.primaryName=Admin+API+V2
  - type: PostmanCollection
    url: collections/circle-community.postman_collection.json
  - type: OpenCollection
    url: collections/circle-community.opencollection.json
  - type: Documentation
    url: https://api.circle.so/apis/headless
  - type: APIReference
    url: https://api-headless.circle.so/?urls.primaryName=Member+APIs
  - type: Documentation
    url: https://api.circle.so/apis/headless/quick-start
  - type: APIReference
    url: https://api-headless.circle.so/?urls.primaryName=Auth+APIs
- aid: circle-community:circle-community-admin-spaces-api
  name: Circle Admin - Spaces API
  description: Spaces, space groups, and their memberships.
  humanURL: https://api.circle.so/apis/admin-api
  baseURL: https://app.circle.so/api/admin/v2
  tags:
  - Admin - Spaces
  properties:
  - type: OpenAPI
    url: openapi/circle-community-admin-spaces-api-openapi.yml
  - type: Documentation
    url: https://api.circle.so/apis/admin-api
  - type: APIReference
    url: https://api-headless.circle.so/?urls.primaryName=Admin+API+V2
  - type: PostmanCollection
    url: collections/circle-community.postman_collection.json
  - type: OpenCollection
    url: collections/circle-community.opencollection.json
  - type: Documentation
    url: https://api.circle.so/apis/headless
  - type: APIReference
    url: https://api-headless.circle.so/?urls.primaryName=Member+APIs
  - type: Documentation
    url: https://api.circle.so/apis/headless/quick-start
  - type: APIReference
    url: https://api-headless.circle.so/?urls.primaryName=Auth+APIs
- aid: circle-community:circle-community-headless-auth-api
  name: Circle Headless - Auth API
  description: Member JWT token exchange for the Headless Member API.
  humanURL: https://api.circle.so/apis/admin-api
  baseURL: https://app.circle.so/api/admin/v2
  tags:
  - Headless - Auth
  properties:
  - type: OpenAPI
    url: openapi/circle-community-headless-auth-api-openapi.yml
  - type: Documentation
    url: https://api.circle.so/apis/admin-api
  - type: APIReference
    url: https://api-headless.circle.so/?urls.primaryName=Admin+API+V2
  - type: PostmanCollection
    url: collections/circle-community.postman_collection.json
  - type: OpenCollection
    url: collections/circle-community.opencollection.json
  - type: Documentation
    url: https://api.circle.so/apis/headless
  - type: APIReference
    url: https://api-headless.circle.so/?urls.primaryName=Member+APIs
  - type: Documentation
    url: https://api.circle.so/apis/headless/quick-start
  - type: APIReference
    url: https://api-headless.circle.so/?urls.primaryName=Auth+APIs
- aid: circle-community:circle-community-headless-member-api
  name: Circle Headless - Member API
  description: Member-authenticated experience endpoints.
  humanURL: https://api.circle.so/apis/admin-api
  baseURL: https://app.circle.so/api/admin/v2
  tags:
  - Headless - Member
  properties:
  - type: OpenAPI
    url: openapi/circle-community-headless-member-api-openapi.yml
  - type: Documentation
    url: https://api.circle.so/apis/admin-api
  - type: APIReference
    url: https://api-headless.circle.so/?urls.primaryName=Admin+API+V2
  - type: PostmanCollection
    url: collections/circle-community.postman_collection.json
  - type: OpenCollection
    url: collections/circle-community.opencollection.json
  - type: Documentation
    url: https://api.circle.so/apis/headless
  - type: APIReference
    url: https://api-headless.circle.so/?urls.primaryName=Member+APIs
  - type: Documentation
    url: https://api.circle.so/apis/headless/quick-start
  - type: APIReference
    url: https://api-headless.circle.so/?urls.primaryName=Auth+APIs
common:
- type: CapabilityMap
  url: capabilities/circle-community-capability-edges.yml
  name: Circle Business Capability Map
- url: https://circle.so/blog
  type: Blog
- type: VendorFacets
  url: vendor-facets/circle-community-vendor-facets.yml
- type: AgenticAccess
  url: agentic-access/circle-community-agentic-access.yml
- type: DomainSecurity
  url: security/circle-community-domain-security.yml
- type: Authentication
  url: authentication/circle-community-authentication.yml
- type: LinkedIn
  url: https://www.linkedin.com/company/circleco
- type: Website
  url: https://circle.so
- type: Documentation
  url: https://api.circle.so
- type: Plans
  url: plans/circle-community-plans-pricing.yml
- type: RateLimits
  url: rate-limits/circle-community-rate-limits.yml
- type: FinOps
  url: finops/circle-community-finops.yml
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
