Circle So Circle Community API
✓ Official Vendor SpecSocial MediaSocial Managementbearer19 EndpointsREST
For Agents
Manage Circle community spaces, members, posts, and comments through 19 admin endpoints. Invite members, create posts in a space, and moderate comments using a bearer-token-authenticated REST API.
Use for: I need to invite a new member to my Circle community, Create a Circle post announcing a new course module, List active members of a Circle community filtered by email, Remove a member who violated community guidelines
Not supported: Does not handle billing, video conferencing, or email marketing — use for Circle community, member, post, and comment management only.
Circle is a community platform used by creators, course operators, and SaaS companies to host members-only spaces, discussions, and events. The Circle Community API exposes 19 admin endpoints over https://app.circle.so/api/v1 covering communities, spaces, space groups, members, posts, and comments. Authentication uses a bearer token issued from Circle admin settings, and most endpoints require a community_id query parameter that scopes the call to a specific Circle community.
Install Jentic One Beta
Connect the Circle Community API to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Circle Community API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Capabilities
What an agent can do with Circle Community API.
Invite a new member to a Circle community by email and assign them to specific spaces
Create a post in a Circle space with title, HTML body, and pin or comment-control flags
List members of a community with pagination and filter by email or invited/active status
Moderate community discussion by deleting individual comments by comment_id
Update a member's profile name, bio, or assigned space_ids
List space groups for a community to organise spaces by topic or audience
Retrieve the authenticated member's profile via /me for session validation
Use Cases
Patterns agents use Circle Community API for, with concrete tasks.
★ Automated Member Onboarding From a Course Platform
When a learner enrols in a course on an external LMS, an automation can call POST /community_members to invite them to the matching Circle community and assign space_ids for their cohort. This avoids manual seat provisioning and supports thousands of monthly enrolments. Skip_invitation can be set to true if the LMS handles the welcome email separately.
POST to /community_members with community_id 12345, email learner@example.com, name 'Alex Lee', and space_ids [678, 901] to invite the new cohort member.
Cross-Posting Announcements Into Circle
A blog or newsletter publishing workflow can mirror new posts into a Circle space using POST /posts. The endpoint accepts an HTML body, pin and comment control flags, and the target space_id, so an editorial workflow can publish a single announcement to a website and to a Circle community simultaneously.
POST to /posts with community_id 12345, space_id 678, name 'Q3 Roadmap', body the announcement HTML, and is_pinned true.
Community Health Reporting
GET /community_members and GET /posts with pagination let an analytics workflow pull weekly snapshots of active membership and posting volume per space. Combined with the comments_count and likes_count fields on Post, this powers a community-health dashboard without scraping the Circle UI.
GET /posts?community_id=12345&space_id=678&per_page=100&sort=latest and aggregate comments_count and likes_count for the last 50 posts.
AI Agent Community Moderation
An AI moderation agent invoked through Jentic can scan recent comments via GET /comments, classify any that violate guidelines, and call DELETE /comments/{comment_id} to remove them. Jentic isolates the Circle bearer token in the MAXsystem vault so the moderation logic never holds the raw credential.
Search Jentic for 'delete a comment in Circle', load the DELETE /comments/{comment_id} schema, then remove comment 555 from community 12345.
Key Endpoints
19 endpoints — circle is a community platform used by creators, course operators, and saas companies to host members-only spaces, discussions, and events.
METHOD
PATH
DESCRIPTION
POST
/community_members
Invite a new member to a community
GET
/community_members
List members of a community
POST
/posts
Create a new post in a space
GET
/posts
List posts in a space
POST
/comments
Create a comment on a post
DELETE
/comments/{comment_id}
Delete a comment
GET
/me
Get current authenticated member profile
POST
/community_members
Invite a new member to a community
GET
/community_members
List members of a community
POST
/posts
Create a new post in a space
GET
/posts
List posts in a space
POST
/comments
Create a comment on a post
DELETE
/comments/{comment_id}
Delete a comment
GET
/me
Get current authenticated member profile
Why Jentic?
Three things that make agents converge on Jentic-routed access.
Credential isolation
Circle bearer tokens are stored encrypted in the Jentic vault (MAXsystem). Agents call /community_members or /posts via Jentic without ever seeing the raw token, so a leaked agent prompt cannot exfiltrate community credentials.
Intent-based discovery
Agents search Jentic by intent (e.g., 'invite a member to Circle') and Jentic returns the matching POST /community_members operation with required fields like community_id and email already in the schema, so the agent does not need to read Circle docs.
Time to first call
Direct Circle integration: 1 day for bearer auth, community_id plumbing, and pagination handling. Through Jentic: under 30 minutes — search, load schema, execute.
Related APIs
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using Circle Community API through Jentic.
What authentication does the Circle Community API use?
Circle uses bearer-token authentication. Generate a token from Circle admin settings and pass it as Authorization: Bearer <token>. Through Jentic the token is stored encrypted in the MAXsystem vault and never exposed to the agent at runtime.
Can I invite members to a Circle community via the API?
Yes. POST /community_members with community_id, email, optional name, space_ids, and skip_invitation invites a new member. Use skip_invitation=true if your own system already sends the welcome email.
What are the rate limits for the Circle Community API?
Circle does not publish hard rate limits in the OpenAPI spec; admin endpoints are intended for back-office use rather than per-request user traffic. Plan batched member sync jobs and let Jentic surface any 429 responses for retry.
How do I create a Circle post through Jentic?
Run pip install jentic, then search Jentic for 'create a post in Circle'. Jentic returns POST /posts with its schema. Supply community_id, space_id, name, and body, and execute. Sign up at https://app.jentic.com/sign-up.
How do I scope a request to a specific community?
Most Circle endpoints require a community_id query parameter. For example GET /spaces?community_id=12345 lists spaces inside that community. Pass community_id consistently across calls — it is the primary tenancy boundary.
Can I moderate comments programmatically?
Yes. GET /comments?community_id=...&post_id=... lists comments on a post and DELETE /comments/{comment_id} removes one. Combined, these support automated moderation workflows that flag and remove off-topic or abusive replies.
GET STARTED