Bettermode API

Name: Bettermode API API
Brand: Bettermode API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentCommunicationsChat Messagingbearer10 EndpointsREST

For Agents

Run GraphQL queries and mutations against a Bettermode community to manage members, posts, spaces, votes, and moderation reports.

Quickstart

Get started with Bettermode 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:
"create a draft post in a bettermode community"

# → Jentic returns the GET /events tool with parameter schema, agent executes.

Capabilities

What an agent can do with Bettermode API API.

Run arbitrary GraphQL queries and mutations against a Bettermode network

Authenticate against a network using app or member access tokens

Create draft posts and invite members into a community

Add members to specific spaces and manage space membership

Add reactions, cast votes, and create tags on posts

GET STARTED

Start building with Bettermode API API

Explore with Jentic

View OpenAPI Document

Jentic publishes the only available OpenAPI document for Bettermode API, keeping it validated and agent-ready.

Jentic publishes the only available OpenAPI specification for Bettermode API, keeping it validated and agent-ready. Bettermode (formerly Tribe) is a community platform exposing a GraphQL API for building custom community apps, automating workflows, syncing data, and extending core functionality. Operations cover members, posts, spaces, analytics, authentication, and moderation. The spec exposes the GraphQL entry points along with eight pre-shaped mutation aliases for common actions such as creating draft posts, inviting members, casting votes, and reporting moderation issues.

Use Cases

Patterns agents use Bettermode API API for, with concrete tasks.

★ Community Member Onboarding

Automate onboarding when a user signs up for a SaaS product by inviting them into the community and adding them to onboarding-specific spaces. /graphql/inviteMembers handles the invitation and /graphql/addSpaceMembers wires them into the right spaces. End-to-end automation against a sign-up webhook is typically 1 day of work.

On a new user webhook, POST /graphql/inviteMembers with the email, then POST /graphql/addSpaceMembers to attach them to the welcome space

Editorial Posting Pipeline

Push articles or announcements from a CMS or marketing tool into Bettermode as draft posts ready for an editor to publish. /graphql/createDraftPost takes the title, body, and target space and returns the draft id, while tagging through /graphql/createTag keeps content organised. A baseline integration is typically half a day to a day.

POST /graphql/createDraftPost with the article title, body, and target space id, then POST /graphql/createTag for any new content tags

Moderation and Engagement Bots

Build a moderation bot that escalates flagged content via /graphql/createModerationReport and an engagement bot that reacts or votes on highlight posts via /graphql/addReaction and /graphql/castVote. The shared /graphql endpoint can run any other query needed for context, such as fetching post detail before deciding to escalate.

When a post matches a moderation rule, POST /graphql/createModerationReport with the post id and reason, then POST /graphql with a query to fetch the post for the audit log

AI Agent for Community Operations

An AI agent uses Jentic to discover Bettermode operations and automate community admin: inviting registrants, drafting weekly digest posts, or running moderation checks. The agent searches by intent, loads the operation schema, and executes against the GraphQL endpoint without learning the schema by hand. Through Jentic, integration takes under an hour.

Search Jentic for 'create bettermode draft post' and execute /graphql/createDraftPost with the weekly digest content for the announcements space

Key Endpoints

10 endpoints — jentic publishes the only available openapi specification for bettermode api, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

POST

/graphql

Run any GraphQL query or mutation

POST

/graphql/loginNetwork

Authenticate against a network and obtain a token

POST

/graphql/createDraftPost

Create a draft post in a space

POST

/graphql/inviteMembers

Invite new members to the community

POST

/graphql/addSpaceMembers

Add members to a specific space

POST

/graphql/addReaction

React to a post

POST

/graphql/castVote

Cast a vote on a poll

POST

/graphql/createModerationReport

File a moderation report

POST

/graphql

Run any GraphQL query or mutation

POST

/graphql/loginNetwork

Authenticate against a network and obtain a token

POST

/graphql/createDraftPost

Create a draft post in a space

POST

/graphql/inviteMembers

Invite new members to the community

POST

/graphql/addSpaceMembers

Add members to a specific space

Why though Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Bettermode app and member access tokens are stored encrypted in the Jentic vault. Agents receive scoped execution rights — the Authorization header is injected at execution time and never appears in the agent's context window.

Intent-based discovery

Agents search Jentic by intent such as 'create bettermode draft post' or 'invite members to community' and Jentic returns the matching pre-shaped mutation with its parameter schema, removing the need to study the GraphQL schema by hand.

Time to first call

Direct Bettermode integration: 2 to 4 days to learn the GraphQL schema, design queries, and handle pagination. Through Jentic: under 1 hour — search, load schema, execute.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Alternative

Discourse API

Open-source forum platform with a REST API as an alternative to Bettermode communities

Use Discourse for self-hosted long-form forums; pick Bettermode for a hosted community-as-product platform with GraphQL.

Complementary

Slack API

Internal team chat to mirror or escalate Bettermode community activity

Use Slack for internal team conversations; use Bettermode for external customer or user community engagement and post both via the same agent.

Alternative

Circle API

Hosted community platform similar to Bettermode with REST endpoints

Pick Circle for course-and-community workflows with native cohort features; choose Bettermode when GraphQL flexibility and white-label branding are key.

FAQs

Specific to using Bettermode API API through Jentic.

Why is there no official OpenAPI spec for Bettermode API?

Bettermode publishes a GraphQL schema rather than an OpenAPI specification. Jentic generates and maintains this OpenAPI spec so that AI agents and developers can call Bettermode API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.

What authentication does the Bettermode API use?

Bettermode uses HTTP Bearer authentication carrying a JWT app access token or member access token in the Authorization header. Tokens are issued via POST /graphql/loginNetwork. When called via Jentic, tokens are stored encrypted in the Jentic vault and injected at execution time so they never enter the agent's context.

Can I run arbitrary GraphQL queries through this API?

Yes. POST /graphql accepts any query or mutation supported by the Bettermode schema, while POST /graphql/member runs the same in a member-scoped context. The other /graphql/<operation> endpoints are pre-shaped wrappers for common mutations such as createDraftPost or addReaction.

How do I invite members through Jentic?

Run pip install jentic and search for 'invite members to bettermode community'. Jentic returns POST /graphql/inviteMembers, the agent loads the input schema, and executes with the email list and target role. Pair with /graphql/addSpaceMembers to land them in the right spaces.

What rate limits apply to the Bettermode API?

Bettermode applies per-token rate limits on the GraphQL endpoint that vary by plan. The OpenAPI spec does not encode these explicitly, so handle 429 responses with backoff and prefer the pre-shaped mutation aliases over composing many round-trips through /graphql when running bulk operations.

Is the Bettermode API free?

Bettermode is a paid community platform with multiple subscription tiers; API access is included with paid plans. There is no separate API charge, but call volume must stay within plan-specific quotas. Pricing tiers are available on bettermode.com.