Discourse - Apps Documentation

Requirements

Discourse requires an active account and an API access token from your account settings to connect — both are set up on its own site.[3]

Get your Discourse credentials

API KeypasswordRequired
Create this in your forum's admin area under API → Keys. Choose a key with Global scope — scoped keys cannot reach every operation this app offers.
[1]
API UsernametextRequired
The forum username this app acts as, for example system. If your API key is tied to a single user, enter that user's username — a different one will be rejected. Most operations here need an administrator.
[1]
HostingselectRequired
Where your forum runs. Both options ask for the forum address.
[1]

Connect Discourse in WEXTL

Log in to your WEXTL account, add the Discourse node module to your workflow, and click Create new credential.
Instant triggers use webhooks — click Create a webhook first when adding one, then create the credential.
Optional: In the Credential name field, enter a name for the credential.
Enter the authentication credentials you copied from your Discourse account, or follow the on-screen instructions to create the credential.
If prompted, authenticate your account and confirm access.
If you want to make changes to your credential in the future, follow the steps in Manage credentials →

Notes

Credentials are org-scoped; share them with teammates from the Credentials picker on any of its nodes.For detailed information on connecting an application, see Connect an application →

Discourse node modules

The list below is a reference of every Discourse node module the integration supports. You will be able to pick any of them on the workflow canvas while building automations.

Browse every Discourse node module below — each one opens to show its input parameters, outputs, and connection requirements.

Watch EventsTrigger

Output fields[3]

Field	Type
Topic	object
Post	object
User	object
Group	object
Category	object
Tag	object
Notification	object

Download BackupSearch

Input fields[3]

Field	Type
BackupRequired	choice
Download tokenRequired	text

Output fields[3]

Field	Type
File	text
Filename	text
Size (bytes)	number
Content type	text

Export Calendar Events ICalSearch

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Get CategorySearch

Input fields[3]

Field	Type
CategoryRequired	choice

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Get Group by IDSearch

Input fields[3]

Field	Type
GroupRequired	choice

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Get Group by NameSearch

Input fields[3]

Field	Type
GroupRequired	choice

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Get PostSearch

Input fields[3]

Field	Type
PostRequired	choice

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Get Site Basic InfoSearch

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Get Site InfoSearch

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Get Specific Posts from TopicSearch

Input fields[3]

Field	Type
TopicRequired	choice
Post Ids	text
Limit	number

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Get TagSearch

Input fields[3]

Field	Type
TagRequired	choice
Limit	number

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Get Tag GroupSearch

Input fields[3]

Field	Type
Tag groupRequired	choice

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Get TopicSearch

Input fields[3]

Field	Type
TopicRequired	choice

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Get Topic by External IDSearch

Input fields[3]

Field	Type
External IDRequired	text

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Get UserSearch

Input fields[3]

Field	Type
UsernameRequired	choice

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Get User by External IDSearch

Input fields[3]

Field	Type
External IDRequired	text

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Get User by ID (Admin)Search

Input fields[3]

Field	Type
UserRequired	choice

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Get User by Identity ProviderSearch

Input fields[3]

Field	Type
ProviderRequired	text
External IDRequired	text

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Get User EmailsSearch

Input fields[3]

Field	Type
UsernameRequired	choice

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

List BackupsSearch

Input fields[3]

Field	Type
Limit	number

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

List BadgesSearch

Input fields[3]

Field	Type
Limit	number

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

List Calendar EventsSearch

Input fields[3]

Field	Type
Limit	number

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

List Category TopicsSearch

Input fields[3]

Field	Type
SlugRequired	text
CategoryRequired	choice
Limit	number

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

List Group MembersSearch

Input fields[3]

Field	Type
GroupRequired	choice
Limit	number

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

List GroupsSearch

Input fields[3]

Field	Type
Limit	number

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

List Latest TopicsSearch

Input fields[3]

Field	Type
Limit	number

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

List NotificationsSearch

Input fields[3]

Field	Type
Limit	number

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

List Post RepliesSearch

Input fields[3]

Field	Type
PostRequired	choice
Limit	number

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

List PostsSearch

Input fields[3]

Field	Type
Limit	number

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

List Private MessagesSearch

Input fields[3]

Field	Type
UsernameRequired	choice
Limit	number

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

List Sent Private MessagesSearch

Input fields[3]

Field	Type
UsernameRequired	choice
Limit	number

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

List Tag GroupsSearch

Input fields[3]

Field	Type
Limit	number

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

List Top TopicsSearch

Input fields[3]

Field	Type
Limit	number

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

List User ActionsSearch

Input fields[3]

Field	Type
Username	text
Limit	number

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

List User BadgesSearch

Input fields[3]

Field	Type
UsernameRequired	choice
Limit	number

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

List Users (Admin)Search

Input fields[3]

Field	Type
Limit	number

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

List Users (Directory)Search

Input fields[3]

Field	Type
Limit	number

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

List Users by FlagSearch

Input fields[3]

Field	Type
FlagRequired	text
Limit	number

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

SearchSearch

Input fields[3]

Field	Type
QRequired	text

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Abort Multipart UploadAction

Input fields[3]

Field	Type
Unique Identifier	text

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Activate UserAction

Input fields[3]

Field	Type
UserRequired	choice

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Add Group MembersAction

Input fields[3]

Field	Type
GroupRequired	choice
Usernames	choice

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Anonymize UserAction

Input fields[3]

Field	Type
UserRequired	choice

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Bookmark TopicAction

Input fields[3]

Field	Type
TopicRequired	choice

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Change PasswordAction

Input fields[3]

Field	Type
TokenRequired	text
Password	text

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Complete External UploadAction

Input fields[3]

Field	Type
Unique Identifier	text

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Complete Multipart UploadAction

Input fields[3]

Field	Type
Unique Identifier	text

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Create BackupAction

Input fields[3]

Field	Type
With uploads	choice

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Create BadgeAction

Input fields[3]

Field	Type
Name	text
Badge Type Id	text
Description	text

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Create CategoryAction

Input fields[3]

Field	Type
Name	text
Color	text
Text Color	text

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Create GroupAction

Input fields[3]

Field	Type
Name	text
Full Name	text

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Create InviteAction

Input fields[3]

Field	Type
Email	text

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Create Multipart UploadAction

Input fields[3]

Field	Type
File Name	text
File Size	text
Upload Type	text

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Create Multiple InvitesAction

Input fields[3]

Field	Type
Email	text

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Create PostAction

Input fields[3]

Field	Type
Raw	text
Topic	choice
Title	text
Category	choice
Target Recipients	text

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Create Tag GroupAction

Input fields[3]

Field	Type
Name	text

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Create Topic TimerAction

Input fields[3]

Field	Type
TopicRequired	choice
Time	text
Status Type	text

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Create UploadAction

Input fields[3]

Field	Type
FileRequired	text
Upload typeRequired	text
Synchronous	boolean

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Create UserAction

Input fields[3]

Field	Type
Name	text
Email	text
Password	text
Username	text

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Deactivate UserAction

Input fields[3]

Field	Type
UserRequired	choice

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Delete BadgeAction

Input fields[3]

Field	Type
BadgeRequired	choice

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Delete GroupAction

Input fields[3]

Field	Type
GroupRequired	choice

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Delete PostAction

Input fields[3]

Field	Type
PostRequired	choice

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Delete TopicAction

Input fields[3]

Field	Type
TopicRequired	choice

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Delete UserAction

Input fields[3]

Field	Type
UserRequired	choice

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Generate Multipart Upload URLsAction

Input fields[3]

Field	Type
Unique Identifier	text
Part Numbers	text

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Initiate External UploadAction

Input fields[3]

Field	Type
File Name	text
File Size	text
Type	text

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Invite Group to TopicAction

Input fields[3]

Field	Type
TopicRequired	choice
Group	choice

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Invite to TopicAction

Input fields[3]

Field	Type
TopicRequired	choice
User	text
Email	text

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Lock PostAction

Input fields[3]

Field	Type
PostRequired	choice
Locked	text

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Log Out UserAction

Input fields[3]

Field	Type
UserRequired	choice

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Make an API Calluniversal

Input fields[3]

Field	Type
URLRequired	text
MethodRequired	choice
Headers	array
Header	object
Query String	array
Parameter	object
Body	text

Output fields[3]

Field	Type
Body	text
Headers	object
Status code	number

Mark Notifications as ReadAction

Input fields[3]

Field	Type
Notification	choice

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Perform Post ActionAction

Input fields[3]

Field	Type
Id	text
Post action typeRequired	choice

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Refresh User GravatarAction

Input fields[3]

Field	Type
UsernameRequired	choice

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Remove Group MembersAction

Input fields[3]

Field	Type
GroupRequired	choice

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Send Download Backup EmailAction

Input fields[3]

Field	Type
BackupRequired	choice

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Send Password Reset EmailAction

Input fields[3]

Field	Type
Login	text

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Set Topic Notification LevelAction

Input fields[3]

Field	Type
TopicRequired	choice
Notification Level	text

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Silence UserAction

Input fields[3]

Field	Type
UserRequired	choice
Reason	text

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Suspend UserAction

Input fields[3]

Field	Type
UserRequired	choice
Suspend Until	text
Reason	text

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Update BadgeAction

Input fields[3]

Field	Type
BadgeRequired	choice
Name	text
Description	text

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Update CategoryAction

Input fields[3]

Field	Type
CategoryRequired	choice
Name	text
Color	text

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Update GroupAction

Input fields[3]

Field	Type
GroupRequired	choice
Name	text
Full Name	text

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Update PostAction

Input fields[3]

Field	Type
PostRequired	choice
Raw	text

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Update Tag GroupAction

Input fields[3]

Field	Type
Tag groupRequired	choice
Name	text

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Update TopicAction

Input fields[3]

Field	Type
TopicRequired	choice
Title	text
Category	choice

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Update Topic StatusAction

Input fields[3]

Field	Type
TopicRequired	choice
Status	text
Enabled	text

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Update Topic TimestampAction

Input fields[3]

Field	Type
TopicRequired	choice
Timestamp	text

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Update UserAction

Input fields[3]

Field	Type
UsernameRequired	choice
Name	text
Title	text

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Update User AvatarAction

Input fields[3]

Field	Type
UsernameRequired	choice
Upload Id	text
Type	text

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Update User EmailAction

Input fields[3]

Field	Type
UsernameRequired	choice
Email	text

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Update UsernameAction

Input fields[3]

Field	Type
UsernameRequired	choice
New Username	text

Output fields[3]

Field	Type
ID	text
Name	text
Status	text
Created at	number
Updated at	number
Data	text

Templates

Look for Discourse templates in the WEXTL template library.

Browse templates →

Explore alternative apps

More apps in Communication category →

References

WEXTL® Discourse Source Code connector implementation.
Our users use cases and automations.
Official API Documentation for Discourse.
WEXTL® visual workflow builder data.

Last updated: Sep 3, 2026 08:02

How we write our apps documentation

How we compile these docs — sources, AI's role, and how we verify.