Discourse
Discourse is an open-source discussion platform designed for online forums, communities, and team collaboration. It offers structured discussions, real-time notifications, trust-based moderation, and customizable integrations to enhance community engagement and knowledge sharing.
How to Integrate Discourse with ZBrain Flow
Click the '+' button in ZBrain Flow.
Search for Discourse in the list of available integrations.
Select the desired action to configure it in the Flow.
How to Create a Discourse Connection in ZBrain Flow
Enter Connection Name – Assign a name to identify your Discourse connection.
Enter API Key – Required to authenticate requests.
Enter API Username – The username associated with the API key.
Obtain API Key and API Username by following these steps:
Log in to your Discourse Admin account.
Navigate to the Admin Panel:
Click on your profile picture (top-right).
Select ‘Admin’ from the dropdown.
Go to the API Section:
Click ‘Settings’ → ‘API’.
Generate a New API Key:
Click ‘New API Key’.
Fill in the details:
Description – Name your API key.
User Level – Choose All Users or Single User.
Scope – Set permissions (Granular, Read-only, or Global).
Click ‘Save’ to generate the API key.
Copy the API Key – You will only see it once, so store it securely.
If ‘Single User’ was selected, enter the username of the associated user.
Enter Website URL – Provide your Discourse instance URL (e.g.,
https://discourse.yourinstance.com).Click ‘Save’ – Your Discourse connection is now set up in ZBrain Flow.
Actions Available in ZBrain Flow
1. Create Post
Create a new post on an existing Discourse topic.
How to Configure:
Select an existing connection or create one.
Enter the Post content.
Enter the Topic ID where the post should be created.
2. Create Topic
Start a new discussion topic in Discourse.
How to Configure:
Select an existing connection or create one.
Enter the post title.
Enter the topic content.
Enter the category ID to assign the topic.
3. Change User Trust Level
Modify a user's trust level in Discourse.
How to Configure:
Select an existing connection or create one.
Enter the user ID.
Enter the new trust level.
4. Add Users to a Group
Assign users to a specific group in Discourse.
How to Configure:
Select an existing connection or create one.
Enter the Group ID.
Add users by clicking ‘+ Add Item.’
5. Send Private Messages
Send a private message to specific users on Discourse.
How to Configure:
Select an existing connection or create one.
Enter the message title.
Enter the message content.
Add users by clicking ‘+ Add Item.’
6. Custom API Call
Perform a custom API request to a specific Discourse endpoint.
How to Configure:
Select an existing connection or create one.
Enter the HTTP Method – Choose from:
GET (Retrieve data)
POST (Send data)
PATCH (Modify data)
PUT (Update or replace data)
DELETE (Remove data)
HEAD (Fetch headers only)
Add Headers – Define request headers using the provided input fields. Authorization headers are automatically injected from your connection.
Add Query Parameters – Enter query parameters using the designated input fields to customize API requests.
Enter JSON Body – Provide request data in JSON format.
Set Timeout (in seconds) – Define the request timeout duration.
Last updated