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.
Get started with Circle Community API in minutes using your preferred integration method.
# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
"jentic": {
"url": "https://api.jentic.com/mcp",
"auth": "oauth"
}
}
# Then ask your agent:
"invite a member to a Circle community"
# → Jentic returns the GET /events tool with parameter schema, agent executes.What an agent can do with Circle Community API 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
GET STARTED
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.
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
Patterns agents use Circle Community API 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.
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
/community_members
Invite a new member to a community
/community_members
List members of a community
/posts
Create a new post in a space
/posts
List posts in a space
/comments
Create a comment on a post
/comments/{comment_id}
Delete a comment
/me
Get current authenticated member profile
/community_members
Invite a new member to a community
/community_members
List members of a community
/posts
Create a new post in a space
/posts
List posts in a space
/comments
Create a comment on a post
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.
Alternatives and complements available in the Jentic catalogue.
CINNOX API
CINNOX handles 1:1 customer messaging while Circle hosts many-to-many community discussion.
Use CINNOX for direct customer support; use Circle for the public community space where members help each other.
Cisco API
Cisco Webex powers internal collaboration that complements Circle's external member community.
Use Webex for team-internal threads; use Circle for the customer-facing community surface.
GoToMeeting API
GoToMeeting hosts the live event sessions promoted in Circle posts.
Use GoToMeeting to schedule a live community Q&A and announce it via a pinned Circle post.
Specific to using Circle Community API 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.
/comments/{comment_id}
Delete a comment
/me
Get current authenticated member profile