Discourse

Create and manage topics and posts on a Discourse forum, search content, manage users and private messages, and browse categories and tags via the Discourse REST API.

19 actions available

A new announcement is marked ready to cross-post to the community

Agent reads the title, body, and target category from the source record

Agent runs Search to confirm no existing topic already covers it

Agent drafts the topic in Markdown against the resolved category ID

Agent confirms the category resolves and the body renders cleanly

Agent posts the drafted topic into the community review channel

A community owner approves before Create Topic publishes it to the forum

What This Integration Enables

Agents can keep a forum current without a person doing the typing, while keeping a person on the decisions that reach members. Create Topic and Create Post / Reply publish content, Search finds existing discussions so an agent can deduplicate before creating, and List Categories resolves the numeric category IDs that Discourse requires. On the member side, Create User provisions accounts, Get User by External ID maps an SSO identity, Send Private Message delivers onboarding notes, and Suspend User handles moderation, with admin operations requiring a global admin key. The connector gives the agent the full housekeeping surface and leaves the member-facing publish and the moderation calls for a human to approve.

Without FlowRunner

Manual cross-posting Someone re-types each announcement into the forum by hand

Duplicate threads New topics get opened without checking whether one already exists

Ad hoc onboarding New members are welcomed whenever a moderator happens to notice them

With FlowRunner

Drafted from source The agent assembles the topic from the announcement record automatically

Deduplicated first Search runs before any topic is created, so threads do not pile up

Consistent welcome Provisioning and the welcome message run the same way every time

Use Case Scenarios

Announcements that deduplicate before they post

A new announcement is marked ready. The agent reads the title, body, and target category, then runs Search to confirm no existing topic already covers it. If none exists, it drafts the topic in Markdown against the category resolved by List Categories and posts the draft into the community review channel. A community owner approves, and Create Topic publishes it. The forum stops accumulating near-duplicate threads, and nothing goes live without a person's read.

Support topics wired to the ticket system

When a support ticket arrives that warrants a public thread, the agent opens a topic with Create Topic and posts follow-ups with Create Post / Reply as the conversation progresses, using reply_to_post_number for threaded replies. The public replies still route through an owner before they post, so the forum reflects an approved answer rather than a first draft.

Member onboarding with a human on the account decision

For a new member, the agent provisions the account with Create User and drafts a welcome to deliver through Send Private Message. Because Create User with active or approved is an admin action, the agent routes the provisioning decision to an admin first, then sends the welcome once approved and logs the account. Onboarding runs the same way every time, and a person still owns who gets an account.

Human-in-Loop Highlight

A topic on a public forum and a suspended member are both acts a community feels, so the connector holds them for a person. This is human-in-the-loop: an execution pattern where AI agents pause autonomously, assemble the relevant context and the decision choices available, route to a human via their preferred channel, and resume the moment the human responds. Before Create Topic publishes an announcement, the agent posts the full draft to the community owner and asks: "Ready to post to [category]: [title and body]. Approve, edit, or hold?" The owner approves, and the agent publishes the approved topic. The same pause guards Suspend User, so no member is removed on the agent's own read. Assembling the topic and finding the right category is the mechanical part. Deciding that a specific message should appear in the community's name, or that a specific member should be suspended, is the judgment part, and it stays with a person. Placing that approval between the drafting and the publish, across every member-facing act an agent can take, is an orchestration problem. Orchestration as a service is the category built to sit above the forum and hold that decision, and FlowRunner is built for that layer.

Agent processes routinely

Detects exception requiring judgment

Clear match Continues automatically

Ambiguous Routes to human via preferred channel

Human decides

Agent resumes with decision

Agent Capabilities

19 actions

Topics & Posts

Create Topic Creates a new topic (thread) in a category and returns the topic ID and slug. The opening post body is raw Markdown. The primary publish action and the step a human approves.
Create Post / Reply Adds a post to an existing topic, optionally as a threaded reply to a specific post number. Used to continue a discussion the agent opened.
Get Topic Retrieves a topic and its posts by topic ID. Used to read a thread's current state.
Get Post Retrieves a single post by its ID.
Update Post Edits the body of an existing post.
Delete Post Deletes a post. Deleting the first post of a topic deletes the whole topic.
Delete Topic Deletes a topic and its posts.
List Latest Topics Lists the most recent topics on the forum. Used to monitor recent activity.
List Top Topics Lists the top topics by activity.

Search

Search Searches forum content to find existing discussions. Used to deduplicate before creating a new topic.

Users

Create User Provisions a new community member. Setting active or approved requires a global admin key, so this action routes through an admin decision.
Get User Retrieves a user by username.
Get User by External ID Looks up a user by their external SSO identifier. Used to map an identity from an external system.
List User Actions Lists a user's recent actions on the forum.
Suspend User Suspends a community member. A moderation action gated behind a human and requiring a global admin key.

Private Messages

Send Private Message Sends a private message to one or more users, for onboarding or notifications.

Start building with Discourse

$100 in credits. No card required. Connect in minutes.

Start Building Free Talk to us