> ## Documentation Index
> Fetch the complete documentation index at: https://docs.automate.ax/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Automate.ax automations are TypeScript programs.
> Use Bun for installation and command examples.
> Use Automate.ax for the product name and automate.ax for the package, CLI, and domain.
> Treat documented public APIs as current; do not invent transitional or deprecated names.

# Reddit

> Automate Reddit publishing, discovery, inboxes, moderation, and community events.

<Warning>
  Reddit connections are temporarily unavailable while Automate.ax awaits
  Reddit's approval for commercial Data API access. You can connect a Reddit
  account after the integration is approved and enabled.
</Warning>

Import Reddit actions and triggers from `automate.ax/reddit`:

```ts automations/watch-reddit.automation.ts theme={null}
import { automation } from "automate.ax"
import { reddit } from "automate.ax/reddit"

export default automation("Watch product feedback", () => {
  const event = reddit.onSubredditEvent({ subreddit: "AutomateAx" })

  if (event.action === "postCreated") {
    reddit.saveContent({ contentId: event.post.id })
  }
})
```

Connect Reddit with OAuth. Automate.ax always requests `identity` so it can label the account, then adds the least Reddit scopes required by your deployed actions and triggers. Reddit issues one-hour access tokens and permanent refresh tokens.

## Content and IDs

Reddit fullnames include a type prefix: posts use `t3_`, comments use `t1_`, private messages use `t4_`, and subreddits use `t5_`. Actions that accept `postId`, `contentId`, `parentId`, or message IDs require these fullnames. Normalized records also expose the provider's short ID.

List actions return `pageInfo.after`. Pass it as the next action's `after` input. Provider timestamps become JavaScript `Date` values.

## Trigger polling

Reddit does not provide Data API webhooks. Automate.ax polls the required listing once per minute, creates an initial baseline, and emits only records first observed afterward. A trigger added to an already shared poll also starts from its own baseline, so it does not replay older records.

New-post, new-comment, and broad subreddit triggers share one poll per Reddit account and subreddit. Inbox and moderation triggers use separate polls so a missing moderation permission cannot stall public subreddit events. Each poll reads up to 1,000 of the newest records in a demanded listing; events beyond that safety bound between polls can be missed.

## Safety and provider behavior

Automate.ax does not expose voting actions because Reddit prohibits automated vote and karma manipulation. Send private messages only after the recipient explicitly consents. Reddit validation errors are returned as action failures, polling and trigger setup honor provider retry delays, and unsafe submissions are not automatically replayed after ambiguous failures.

## Exports

```ts theme={null}
import { reddit, redditAccount } from "automate.ax/reddit"
```

* `reddit` contains the packaged Reddit actions and triggers.
* `redditAccount("name")` selects a named Reddit connection.

## Triggers

* [Subreddit event](/reference/integrations/reddit/triggers/on-subreddit-event)
* [New post](/reference/integrations/reddit/triggers/on-new-post)
* [New comment](/reference/integrations/reddit/triggers/on-new-comment)
* [New inbox item](/reference/integrations/reddit/triggers/on-new-inbox-item)
* [New mod queue item](/reference/integrations/reddit/triggers/on-new-mod-queue-item)

## Actions

* [Get profile](/reference/integrations/reddit/actions/get-profile)
* [Get subreddit](/reference/integrations/reddit/actions/get-subreddit)
* [List posts](/reference/integrations/reddit/actions/list-posts)
* [Search posts](/reference/integrations/reddit/actions/search-posts)
* [Get post](/reference/integrations/reddit/actions/get-post)
* [List comments](/reference/integrations/reddit/actions/list-comments)
* [Create text post](/reference/integrations/reddit/actions/create-text-post)
* [Create link post](/reference/integrations/reddit/actions/create-link-post)
* [Create comment](/reference/integrations/reddit/actions/create-comment)
* [Edit content](/reference/integrations/reddit/actions/edit-content)
* [Delete content](/reference/integrations/reddit/actions/delete-content)
* [Save content](/reference/integrations/reddit/actions/save-content)
* [Unsave content](/reference/integrations/reddit/actions/unsave-content)
* [Report content](/reference/integrations/reddit/actions/report-content)
* [Hide posts](/reference/integrations/reddit/actions/hide-posts)
* [Unhide posts](/reference/integrations/reddit/actions/unhide-posts)
* [Subscribe to subreddit](/reference/integrations/reddit/actions/subscribe-subreddit)
* [Unsubscribe from subreddit](/reference/integrations/reddit/actions/unsubscribe-subreddit)
* [List inbox](/reference/integrations/reddit/actions/list-inbox)
* [Mark messages read](/reference/integrations/reddit/actions/mark-messages-read)
* [Mark messages unread](/reference/integrations/reddit/actions/mark-messages-unread)
* [Send private message](/reference/integrations/reddit/actions/send-private-message)
* [Reply to message](/reference/integrations/reddit/actions/reply-to-message)
* [List mod queue](/reference/integrations/reddit/actions/list-mod-queue)
* [Approve content](/reference/integrations/reddit/actions/approve-content)
* [Remove content](/reference/integrations/reddit/actions/remove-content)
* [Lock content](/reference/integrations/reddit/actions/lock-content)
* [Unlock content](/reference/integrations/reddit/actions/unlock-content)
* [List post flairs](/reference/integrations/reddit/actions/list-post-flairs)
* [Set post flair](/reference/integrations/reddit/actions/set-post-flair)