Connectors
Social & Media
Social discussion platform: posts, comments, subreddits, and message data
Reddit API referenceAPI checked August 18, 2026
- Signs in with
- API token
- Runs on
- Cloud or On-Prem Worker
- Operations
- 205
- Ready-made triggers
- 0
Connect Reddit
- In Neblex open Connect › Connections and click New Connection.
- Search for Reddit and give the connection a clear name.
- Fill in the fields. Secret values are encrypted and never shown again.
- Click Test, then Create Connection.
| Field | What to enter |
|---|---|
| Access tokenRequiredSecret | OAuth access token. |
| User-AgentRequired | Unique Reddit-required client identification, e.g. platform:app:version (by /u/name). |
Use it in a flow
- Open a flow, open the node library and search for Reddit.
- Drag it onto the canvas and choose an Operation and your connection.
- Map the operation's fields from earlier steps, or click Map with Matt.
- Use Test this step to see what it returns, then save.
To start a flow from Reddit without a ready-made trigger: a Poll for changes trigger can check one of its list operations on a schedule and pass on only what is new; if Reddit can send webhooks, a Webhook trigger receives them at its own URL.
Operations
205 operations in 15 groups. Each one is a step you can add to a flow.
Account15
Get my identitygetMe | GET | Returns the identity of the user. |
Get my karmagetMyKarma | GET | Return a breakdown of subreddit karma. |
Get my prefsgetMyPrefs | GET | Return the preference settings of the logged in user |
Get my trophiesgetMyTrophies | GET | Return a list of trophies for the current user. |
Get prefs listgetPrefsList | GET | This endpoint is a listing . |
Get scopesgetScopes | GET | Retrieve descriptions of reddit's OAuth2 scopes. |
Hide announcementshideAnnouncements | POST | Accepts a list of announcement fullnames ( ann ) and marks them hidden if they belong to the authenticated user |
List announcementslistAnnouncements | GET | Fetch announcements from Reddit. |
List blockedgetMyBlocked | GET | This endpoint is a listing . |
List friendsgetMyFriends | GET | This endpoint is a listing . |
Needs captchaneedsCaptcha | GET | Check whether ReCAPTCHAs are needed for API methods |
Read all announcementsreadAllAnnouncements | POST | Marks all unread announcements as read for the authenticated user |
Read announcementsreadAnnouncements | POST | Accepts a list of announcement fullnames ( ann ) and marks them read if they belong to the authenticated user |
Unread announcementsgetUnreadAnnouncements | GET | Fetch announcements from Reddit. |
Update my prefsupdateMyPrefs | PATCH | Change the user's preferences. |
Emoji5
Acquire emoji upload leaseacquireEmojiUploadLease | POST | Acquire and return an upload lease to s3 temp bucket. |
Add an emojiaddEmoji | POST | Add an emoji to the DB by posting a message on emoji upload q. A job processor that listens on a queue, uses the s3 key provided in the request to locate the image in S3 Temp Bucket and... |
Delete an emojideleteEmoji | DELETE | Delete a Subreddit emoji. |
List emojislistEmojis | GET | Get all emojis for a SR. |
Set emoji custom sizesetEmojiCustomSize | POST | Set custom emoji size. |
Flair17
Clear flair templatesclearFlairTemplates | POST | Delete all flair templates of a type. |
Configure flairconfigureFlair | POST | Set subreddit flair configuration. |
Create flair templatecreateFlairTemplate | POST | Create or update a flair template. |
Create flair template (v2)createFlairTemplateV2 | POST | Create or update a flair template. |
Delete flair templatedeleteFlairTemplate | POST | Delete a flair template by ID. |
Delete user flairdeleteFlair | POST | Remove a user's flair. |
Get flair selectorgetFlairSelector | POST | Return information about a users's flair options. |
Get link flairgetLinkFlair | GET | Return list of available link flair for the current subreddit. |
Get link flair (v2)getLinkFlairV2 | GET | Return list of available link flair for the current subreddit. |
Get user flairgetUserFlair | GET | Return list of available user flair for the current subreddit. |
Get user flair (v2)getUserFlairV2 | GET | Return list of available user flair for the current subreddit. |
List flairlistFlair | GET | This endpoint is a listing . |
Reorder flair templatesreorderFlairTemplates | PATCH | Update the order of flair templates in the specified subreddit. |
Select flairselectFlair | POST | Assign a flair template to a user/link. |
Set flairsetFlair | POST | Set a user's or link's flair. |
Set flair enabledsetFlairEnabled | POST | Enable/disable flair for the user. |
Upload flair CSVuploadFlairCsv | POST | Change the flair of multiple users in the same subreddit with a single API call. |
Listing8
Get bestgetBest | GET | This endpoint is a listing . |
Get by IDsgetById | GET | Get a listing of links by fullname. |
Get commentsgetComments | GET | Get the comment tree for a given Link article . |
Get duplicatesgetDuplicates | GET | Return a list of other submissions of the same URL This endpoint is a listing . |
Get hotgetHot | GET | This endpoint is a listing . |
Get newgetNew | GET | This endpoint is a listing . |
Get risinggetRising | GET | This endpoint is a listing . |
Get sorted listinggetSorted | GET | This endpoint is a listing . |
Live22
Accept contributor inviteacceptContributorInvite | POST | Accept a pending invitation to contribute to the thread. |
Close a live threadcloseLiveThread | POST | Permanently close the thread, disallowing future updates. |
Create a live threadcreateLiveThread | POST | Create a new live thread. |
Delete an updatedeleteLiveUpdate | POST | Delete an update from the thread. |
Edit a live threadeditLiveThread | POST | Configure the thread. |
Get a live threadgetLiveThread | GET | Get a list of updates posted in this thread. |
Get an updategetLiveUpdate | GET | Get details about a specific update in a live thread. |
Get contributorsgetLiveThreadContributors | GET | Get a list of users that contribute to this thread. |
Get discussionsgetLiveThreadDiscussions | GET | Get a list of reddit submissions linking to this thread. |
Get live thread aboutgetLiveThreadAbout | GET | Get some basic information about the live thread. |
Get live threads by IDgetLiveThreadsById | GET | Get a listing of live events by id. |
Happening nowgetHappeningNow | GET | Get some basic information about the currently featured live thread. |
Hide a discussionhideLiveDiscussion | POST | Hide a linked comment thread from the discussions sidebar and listing. |
Invite a contributorinviteContributor | POST | Invite another user to contribute to the thread. |
Leave as contributorleaveContributor | POST | Abdicate contributorship of the thread. |
Post an updatepostLiveUpdate | POST | Post an update to the thread. |
Remove a contributorremoveContributor | POST | Revoke another user's contributorship. |
Remove contributor inviteremoveContributorInvite | POST | Revoke an outstanding contributor invite. |
Report a live threadreportLiveThread | POST | Report the thread for violating the rules of reddit. |
Set contributor permissionssetContributorPermissions | POST | Change a contributor or contributor invite's permissions. |
Strike an updatestrikeLiveUpdate | POST | Strike (mark incorrect and cross out) the content of an update. |
Unhide a discussionunhideLiveDiscussion | POST | Unhide a linked comment thread from the discussions sidebar and listing.. |
Message5
Compose a messagecomposeMessage | POST | Handles message composition under /message/compose. |
Delete a messagedeleteMessage | POST | Delete messages from the recipient's view of their inbox. |
Get messagesgetMessages | GET | This endpoint is a listing . |
Read a messagereadMessage | POST | Mark a message read. |
Read all messagesreadAllMessages | POST | Queue up marking all messages for a user as read. |
Moderation15
Accept moderator inviteacceptModeratorInvite | POST | Accept an invite to moderate the specified subreddit. |
Approveapprove | POST | Approve a link or comment. |
Distinguishdistinguish | POST | Distinguish a thing's author with a sigil. |
Get mod listinggetModListing | GET | Return a listing of posts relevant to moderators. |
Get mod loggetModLog | GET | Get a list of recent moderation actions. |
Get stylesheetgetStylesheet | GET | Redirect to the subreddit's stylesheet if one exists. |
Ignore reportsignoreReports | POST | Prevent future reports on a thing from causing notifications. |
Leave contributorleaveContributorMod | POST | Abdicate approved user status in a subreddit. |
Leave moderatorleaveModerator | POST | Abdicate moderator status in a subreddit. |
Removeremove | POST | Remove a link, comment, or modmail message. |
Show commentshowComment | POST | Mark a comment that it should not be collapsed because of crowd control. |
Snooze reportssnoozeReports | POST | Prevent future reports on a thing from causing notifications. |
Unignore reportsunignoreReports | POST | Allow future reports on a thing to cause notifications. |
Unsnooze reportsunsnoozeReports | POST | For users whose reports were snoozed (see /api/snooze reports ), to go back to escalating future reports from those users. |
Update crowd controlupdateCrowdControlLevel | POST | Change the post's crowd control level. |
Modmail23
Approve authorapproveModmailAuthor | POST | Approve the non mod user associated with a particular conversation. |
Archive a conversationarchiveModmail | POST | Marks a conversation as archived. |
Bulk read modmailbulkReadModmail | POST | Marks all conversations read for a particular conversation state within the passed list of subreddits. |
Create a conversationcreateModmailConversation | POST | Creates a new conversation for a particular SR. |
Create a mod notecreateModNote | POST | Create a mod user note where type=NOTE. |
Delete a mod notedeleteModNote | DELETE | Delete a mod user note where type=NOTE. |
Disapprove authordisapproveModmailAuthor | POST | Disapprove the non mod user associated with a particular conversation. |
Get a conversationgetModmailConversation | GET | Returns all messages, mod actions and conversation metadata for a given conversation id |
Get mod notesgetModNotes | GET | Get mod notes for a specific user in a given subreddit. |
Get recent mod notesgetRecentModNotes | GET | Fetch the most recent notes written by a moderator Both parameters should be comma separated lists of equal lengths. |
Get unread countgetModmailUnreadCount | GET | Endpoint to retrieve the unread conversation count by conversation state. |
Highlight a conversationhighlightModmail | POST | Marks a conversation as highlighted. |
List conversationslistModmailConversations | GET | Get conversations for a logged in user or subreddits |
List modmail subredditslistModmailSubreddits | GET | Returns a list of srs that the user moderates with mail permission |
Mark readmarkModmailRead | POST | Marks a conversations as read for the user. |
Mark unreadmarkModmailUnread | POST | Marks conversations as unread for the user. |
Mute a conversationmuteModmail | POST | Mutes the non mod user associated with a particular conversation. |
Reply to a conversationreplyModmail | POST | Creates a new message for a particular conversation. |
Temp-ban from conversationtempBanModmail | POST | Temporary ban (switch from permanent to temporary ban) the non mod user associated with a particular conversation. |
Unarchive a conversationunarchiveModmail | POST | Marks conversation as unarchived. |
Unban from conversationunbanModmail | POST | Unban the non mod user associated with a particular conversation. |
Unhighlight a conversationunhighlightModmail | DELETE | Removes a highlight from a conversation. |
Unmute a conversationunmuteModmail | POST | Unmutes the non mod user associated with a particular conversation. |
Multireddit12
Add subredditaddMultiredditSubreddit | PUT | Add a subreddit to a multi. |
Copy a multiredditcopyMultireddit | POST | Copy a multi. |
Create a multiredditcreateMultireddit | POST | Create a multi. |
Create/update a multiredditcreateOrUpdateMultireddit | PUT | Create or update a multi. |
Delete a multiredditdeleteMultireddit | DELETE | Delete a multi. |
Get a multiredditgetMultireddit | GET | Fetch a multi's data and subreddit list by name. |
Get descriptiongetMultiredditDescription | GET | Get a multi's description. |
Get multireddit subredditgetMultiredditSubreddit | GET | Get data about a subreddit in a multi. |
Get my multiredditsgetMyMultireddits | GET | Fetch a list of multis belonging to the current user. |
Get user multiredditsgetUserMultireddits | GET | Fetch a list of public multis belonging to username |
Remove subredditremoveMultiredditSubreddit | DELETE | Remove a subreddit from a multi. |
Update descriptionupdateMultiredditDescription | PUT | Change a multi's markdown description. |
Post25
Comment or replycomment | POST | Submit a new comment or reply to a message. |
Delete a thingdelete | POST | Delete a Link or Comment. |
Edit user texteditUserText | POST | Edit the body text of a comment or self-post. |
Follow a postfollowPost | POST | Follow or unfollow a post. |
Get info by fullnameinfo | GET | Return a listing of things specified by their fullnames. |
Get more childrenmoreChildren | GET | Retrieve additional comments omitted from a base comment tree. |
Hidehide | POST | Hide a link. |
Locklock | POST | Lock a link or comment. |
Mark NSFWmarkNsfw | POST | Mark a link NSFW. |
Mark spoilerspoiler | POST | Mark a link as a spoiler. |
Reportreport | POST | Report a link, comment or message. |
Savesave | POST | Save a link or comment. |
Saved categoriessavedCategories | GET | Get a list of categories in which things are currently saved. |
Set contest modesetContestMode | POST | Set or unset "contest mode" for a link's comments. |
Set send repliessendReplies | POST | Enable or disable inbox replies for a link or comment. |
Set subreddit stickysetSubredditSticky | POST | Set or unset a Link as the sticky in its subreddit. |
Set suggested sortsetSuggestedSort | POST | Set a suggested sort for a link. |
Store visitsstoreVisits | POST | Requires a subscription to reddit premium |
Submit a postsubmit | POST | Submit a link to a subreddit. |
Unhideunhide | POST | Unhide a link. |
Unlockunlock | POST | Unlock a link or comment. |
Unmark NSFWunmarkNsfw | POST | Remove the NSFW marking from a link. |
Unmark spoilerunspoiler | POST | Remove the spoiler flag. |
Unsaveunsave | POST | Unsave a link or comment. |
Votevote | POST | Cast a vote on a thing. |
Search1
Searchsearch | GET | Search links page. |
Subreddit26
Autocomplete subredditssubredditAutocomplete | GET | Return a list of subreddits and data for subreddits whose names start with 'query'. |
Autocomplete subreddits (v2)subredditAutocompleteV2 | GET | Subreddit autocomplete (v2). |
Configure subredditsiteAdmin | POST | Create or configure a subreddit. |
Delete bannerdeleteSubredditBanner | POST | Remove the subreddit's custom mobile banner. |
Delete headerdeleteSubredditHeader | POST | Remove the subreddit's custom header image. |
Delete icondeleteSubredditIcon | POST | Remove the subreddit's custom mobile icon. |
Delete imagedeleteSubredditImage | POST | Remove an image from the subreddit's custom image set. |
Get my subredditsgetMySubreddits | GET | Get subreddits the user has a relationship with. |
Get post requirementsgetPostRequirements | GET | Fetch moderator-designated requirements to post to the subreddit. |
Get submit textgetSubmitText | GET | Get the submission text for the subreddit. |
Get subreddit aboutgetSubredditAbout | GET | Return information about the subreddit. |
Get subreddit rulesgetSubredditRules | GET | Get the rules for the current subreddit |
Get subreddit settingsgetSubredditAboutEdit | GET | Get the current settings of a subreddit. |
Get subreddit sidebargetSubredditSidebar | GET | Get the sidebar for the current subreddit |
Get subreddit stickygetSubredditSticky | GET | Redirect to one of the posts stickied in the current subreddit The "num" argument can be used to select a specific sticky, and will default to 1 (the top sticky) if not specified. |
Get subreddit trafficgetSubredditTraffic | GET | A subreddit's traffic stats. |
Get subreddit usersgetSubredditAboutWhere | GET | This endpoint is a listing . |
Get subredditsgetSubreddits | GET | Get all subreddits. |
Recommend subredditsrecommendSubreddits | GET | DEPRECATED: Return subreddits recommended for the given subreddit(s). |
Search subreddit namessearchRedditNames | GET | List subreddit names that begin with a query string. |
Search subreddit names (POST)searchRedditNamesPost | POST | List subreddit names that begin with a query string. |
Search subredditssearchSubreddits | POST | List subreddits that begin with a query string. |
Search subreddits listingsearchSubredditsListing | GET | Search subreddits by title and description. |
Subscribesubscribe | POST | Subscribe to or unsubscribe from a subreddit. |
Update stylesheetupdateSubredditStylesheet | POST | Update a subreddit's stylesheet. |
Upload subreddit imageuploadSubredditImage | POST | Add or replace a subreddit image, custom header logo, custom mobile icon, or custom mobile banner. |
User14
Add a friendaddFriend | PUT | Create or update a "friend" relationship. |
Block a userblockUser | POST | For blocking a user. |
Friend/ban a userfriend | POST | Create a relationship between a user and another user or subreddit OAuth2 use requires appropriate scope based on the 'type' of the relationship: moderator: Use "moderator invite"... |
Get user aboutgetUserAbout | GET | Return information about the user, including karma and gold status. |
Get user data by IDsgetUserDataByAccountIds | GET | User data for account fullnames. |
Get user listinggetUserListing | GET | This endpoint is a listing . |
Get user trophiesgetUserTrophies | GET | Return a list of trophies for the a given user. |
Get usersgetUsers | GET | Get all user subreddits. |
Remove a friendremoveFriend | DELETE | Stop being friends with a user. |
Report a userreportUser | POST | Report a user. |
Search userssearchUsers | GET | Search user profiles by title and description. |
Set permissionssetPermissions | POST | Set a user's permissions in a subreddit. |
Unfriend/unban a userunfriend | POST | Remove a relationship between a user and another user or subreddit The user can either be passed in by name (nuser) or by fullname (iuser). |
Username availableusernameAvailable | GET | Check whether a username is available for registration. |
Widget6
Acquire widget image leaseacquireWidgetImageLease | POST | Acquire and return an upload lease to s3 temp bucket. |
Add a widgetaddWidget | POST | Add and return a widget to the specified subreddit Accepts a JSON payload representing the widget data to be saved. |
Delete a widgetdeleteWidget | DELETE | Delete a widget from the specified subreddit (if it exists) |
Get widgetsgetWidgets | GET | Return all widgets for the given subreddit |
Reorder widgetsreorderWidgets | PATCH | Update the order of widget ids in the specified subreddit |
Update a widgetupdateWidget | PUT | Update and return the data of a widget. |
Wiki11
Allow/deny wiki editorwikiAllowEditor | POST | Allow/deny username to edit this wiki page |
Edit a wiki pageeditWikiPage | POST | Edit a wiki page |
Get a wiki pagegetWikiPage | GET | Return the content of a wiki page If v is given, show the wiki page as it was at that version If both v and v2 are given, show a diff of the two |
Get page revisionsgetWikiPageRevisions | GET | Retrieve a list of revisions of this wiki page This endpoint is a listing . |
Get page settingsgetWikiPageSettings | GET | Retrieve the current permission settings for page |
Get wiki discussionsgetWikiDiscussions | GET | Retrieve a list of discussions about this wiki page This endpoint is a listing . |
Get wiki pagesgetWikiPages | GET | Retrieve a list of wiki pages in this subreddit |
Get wiki revisionsgetWikiRevisions | GET | Retrieve a list of recently changed wiki pages in this subreddit |
Hide a wiki revisionhideWikiRevision | POST | Toggle the public visibility of a wiki page revision |
Revert a wiki pagerevertWikiPage | POST | Revert a wiki page to revision |
Update page settingsupdateWikiPageSettings | POST | Update the permissions and visibility of wiki page |