Circle

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.

Circle publishes 8 APIs on the APIs.io network, including Realtime WebSocket API, Admin - Courses API, Admin - Events API, and 5 more. Tagged areas include Community, Creators, Courses, Memberships, and Event.

The Circle catalog on APIs.io includes 1 event-driven AsyncAPI specification and 1 Spectral governance ruleset.

Circle’s developer surface includes authentication, documentation, and 7 more developer resources.

🌐 Visit website 📡 Source on GitHub

40.0/100 developing ▬ flat Agent 30/100 agent ready saas Full breakdown ↓
scored 2026-09-14 · rubric v0.22.0

AccessPaid

1 APIs

Community Creators Courses Memberships Event Chat Community Platform

Kin Score

Kin Score How this is scored →
scored 2026-09-14 · rubric v0.22.0

Composite quality — 40.0/100 · developing

Contract Quality 13.1 / 23

Developer Ergonomics 5.4 / 18

Access Clarity 7.1 / 18

Operational Transparency 3.7 / 12

Contract Governance 1.2 / 11

Discoverability 6.2 / 9

Create-or-Update Ergonomics 0.0 / 10

Agent readiness — 30/100 · agent ready

Machine-Readable Contract 18 / 18

Agentic Access Contract 10 / 10

Documented Reversibility 0 / 6

MCP Server 12 / 12

Machine-Readable Auth 10 / 10

Idempotency 0 / 9

Stable Error Semantics 0 / 8

Request/Response Examples 0 / 7

Rate-Limit Signaling 7 / 7

Typed Event Surface 6 / 6

Agent Skills 0 / 5

Well-Known Catalog 0 / 4

Consent & Bot Identity 0 / 3

A2A Agent Card 0 / 8

Dry-Run / Simulate Mode 0 / 4

Delegated User Identity 0 / 6

Protected Resource Metadata 0 / 5

Registration Without a Human 0 / 6

Agentic Commerce Well-Known Document 0 / 5

Create-or-Update Ergonomics applies to this provider. This API accepts writes, so it carries 10 points of the composite. It is scored from the published contracts themselves: whether a caller can create-or-update in one call, whether the write accepts a key the caller already holds, and whether the response says which branch ran. Without that, every write needs a search-and-branch in front of it, and the first time that check is skipped a duplicate record is created. Scored against the observed mean rather than raw — a provider at the catalog average is unchanged by this facet, not penalised by it.

Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. Every facet and dimension name above is a link: it opens that measurement's own page — what it means, the exact checks that feed it, how the whole catalog distributes on it, and the providers at the top of it. This rating is computed from github.com/api-evangelist/circle-community: open an issue to ask a question, or submit a pull request to add artifacts. Submit an artifact on GitHub — free → Manage your own listing — the Influence plan, $499/mo →

APIs 8

Individual APIs this provider publishes, each with its own machine-readable definition.

Circle Realtime WebSocket API

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...

Circle Admin - Courses API

Course sections, lessons, and progress.

Circle Admin - Events API

Events and event attendees.

Circle Admin - Members API

Admin-authenticated community member management.

Circle Admin - Posts API

Posts, comments, and topics.

Circle Admin - Spaces API

Spaces, space groups, and their memberships.

Circle Headless - Auth API

Member JWT token exchange for the Headless Member API.

Circle Headless - Member API

Member-authenticated experience endpoints.

Scroll for all 8

Open Collections 9

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

API Collection

OPEN COLLECTION

Circle Developer Platform Admin - Courses API

OPEN COLLECTION

Circle Developer Platform Admin - Courses Admin - Events API

OPEN COLLECTION

Circle Developer Platform Admin - Courses Admin - Members API

OPEN COLLECTION

Circle Developer Platform Admin - Courses Admin - Posts API

OPEN COLLECTION

Circle Developer Platform Admin - Courses Admin - Spaces API

OPEN COLLECTION

Circle Developer Platform Admin - Courses Headless - Auth API

OPEN COLLECTION

Circle Developer Platform Admin - Courses Headless - Member API

OPEN COLLECTION

Circle Developer Platform API

OPEN COLLECTION

Scroll for all 9

Pricing Plans 1

Published pricing tiers and plan structures.

Circle Community Plans Pricing

4 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Circle Community Rate Limits

4 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Circle Community Finops

FINOPS

Event Specifications 1

AsyncAPI definitions for this provider's event-driven and streaming APIs.

Circle Realtime WebSocket API (Beta)

Circle exposes a documented public WebSocket API for realtime chat and notifications, in beta for customers on the Business plan and above. The transport is ActionCable (Rails' ...

ASYNCAPI

Spectral Rules 1

Spectral governance rulesets for linting and validating these APIs.

Circle API Rules

8 rules · 1 errors 7 warnings

SPECTRAL

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Circle Community Authentication

apiKey/http · 2 schemes

SECURITY

Circle Community Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Circle Community Agentic Access

69 operations · 38 acting

AGENTIC

Resources

Documentation 1

Reference material describing how the API behaves

Documentation

Documentation

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess

AgenticAccess

Access & Security 2

Authentication, authorization, and security posture

DomainSecurity

DomainSecurity

Authentication

Authentication

Operate 1

Status, limits, changes, and where to get help

RateLimits

RateLimits

Commercial 2

Pricing, plans, and the legal terms of use

Plans

Plans

FinOps

FinOps

Company 2

The organization behind the API

LinkedIn

Website

Website

Source (apis.yml)

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
tags:
- Community
- Creators
- Courses
- Memberships
- Event
- Chat
- Community Platform
tags_raw:
- Community
- Creators
- Courses
- Memberships
- Events
- Chat
- Community Platform
created: '2026-07-05'
modified: '2026-07-05'
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: 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

Work with this as data

Every provider here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for providers

9 MCP tools reach this

find_providersBrowse and filter every provider in the catalog.
get_provider_artifactsEvery artifact this provider publishes, grouped by type.
get_provider_operationsEvery operation across all of their OpenAPIs — one call instead of parsing every spec.
get_provider_toolsEvery MCP tool they ship, with the operation each wraps.
get_provider_evidenceHow each part of their score was established. Free — the basis for a claim should not sit behind it.
get_provider_ratingPRO — composite, band, trend and facet scores.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This provider

curl "https://apis.io/api/v1/providers/circle-community"

All providers

curl "https://apis.io/api/v1/providers?limit=25"

Every operation they expose

curl "https://apis.io/api/v1/providers/circle-community/operations?limit=25"

How their score was established

curl "https://apis.io/api/v1/providers/circle-community/evidence"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.