Reddit

Access subreddits, posts, comments, and user data via the Reddit API.

Detail	Value
Category	Social Media
Base URL	https://oauth.reddit.com
Authentication	OAuth2
Endpoints	6
Connector key	reddit

Using Reddit in a workflow

1. Go to Connections and click New Connection.
2. Pick Reddit from the marketplace.
3. Enter your credentials (see Authentication above for what's expected).
4. In a workflow, drop an API Call node and select this connection.
5. Pick the operation you need from the Operation dropdown. The full list is below.

Available endpoints

Endpoint	Summary
GET /api/v1/me	Get authenticated user
GET /r/{subreddit}/hot	Get hot posts
POST /api/submit	Submit a post
POST /api/comment	Post a comment
GET /search	Search Reddit
GET /r/{subreddit}/about	Get subreddit info

Each endpoint is documented in full below. Use the outline on the right to jump to one.

GET /api/v1/me

Get authenticated user

Detail	Value
Operation ID	social.getMe
Method	GET
Path	/api/v1/me

Parameters

No parameters.

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your Reddit connection from the Connection dropdown.
3. In the Operation dropdown, select social.getMe.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Reddit API reference.

GET /r/{subreddit}/hot

Get hot posts

Detail	Value
Operation ID	social.getHotPosts
Method	GET
Path	/r/{subreddit}/hot

Parameters

Name	Location	Type	Required
subreddit	path	string	Yes

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your Reddit connection from the Connection dropdown.
3. In the Operation dropdown, select social.getHotPosts.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

Required fields are marked: fill them or the call will fail at runtime.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Reddit API reference.

POST /api/submit

Submit a post

Detail	Value
Operation ID	social.submitPost
Method	POST
Path	/api/submit

Parameters

No parameters.

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your Reddit connection from the Connection dropdown.
3. In the Operation dropdown, select social.submitPost.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Reddit API reference.

POST /api/comment

Post a comment

Detail	Value
Operation ID	social.createComment
Method	POST
Path	/api/comment

Parameters

No parameters.

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your Reddit connection from the Connection dropdown.
3. In the Operation dropdown, select social.createComment.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Reddit API reference.

GET /search

Search Reddit

Detail	Value
Operation ID	social.search
Method	GET
Path	/search

Parameters

Name	Location	Type	Required
q	query	string	Yes

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your Reddit connection from the Connection dropdown.
3. In the Operation dropdown, select social.search.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

Required fields are marked: fill them or the call will fail at runtime.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Reddit API reference.

GET /r/{subreddit}/about

Get subreddit info

Detail	Value
Operation ID	social.getSubredditInfo
Method	GET
Path	/r/{subreddit}/about

Parameters

Name	Location	Type	Required
subreddit	path	string	Yes

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your Reddit connection from the Connection dropdown.
3. In the Operation dropdown, select social.getSubredditInfo.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

Required fields are marked: fill them or the call will fail at runtime.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Reddit API reference.