# New comments on a post — Reddit

> Emit new event each time a new comment is added to a subreddit.

- Key: `reddit-new-comments-on-a-post`
- Type: Trigger (Polling)
- Version: 0.1.3
- App: Reddit (`reddit`) — https://pipedream.com/apps/reddit.md
- This page (HTML): https://pipedream.com/apps/reddit/triggers/new-comments-on-a-post
- Source: https://github.com/PipedreamHQ/pipedream/blob/master/components/reddit/sources/new-comments-on-a-post/new-comments-on-a-post.mjs

## Props

| Prop | Type | Required | Description |
|---|---|---|---|
| `timer` | `$.interface.timer` | Yes | Pipedream polls Reddit for events on this schedule. |
| `subreddit` | `string` | Yes | The subreddit you'd like to watch. Options are loaded from the connected account. |
| `subredditPost` | `string` | Yes | Select a subreddit post or enter a custom expression to reference a specific Post ID in base36 (for example, 15bfi0). Options are loaded from the connected account. |
| `numberOfParents` | `integer` | No | When set to 0, the emitted events will only contain the new comment. Otherwise, the events will also contain the parents of the new comment up to the number indicated in this property. |
| `depth` | `integer` | No | If set to 1, it will include, in the emitted event, only new comments that are direct children to the subreddit pointed by "subredditPost". Furthermore, "depth" determines the maximum depth of children, within the related subreddit comment tree, of new comments to be included in said emitted event. |
| `includeSubredditDetails` | `boolean` | No | If set to true, subreddit details will be expanded/included. |

## Returns

Events emitted by Reddit.

## Run it

**TypeScript**

```ts
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const deployed = await pd.triggers.deploy({
  id: "reddit-new-comments-on-a-post",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    reddit: { authProvisionId: "apn_xxxxxxx" },
    timer: { "intervalSeconds": 900 },
    subreddit: "Subreddit",
  },
  webhookUrl: "https://example.com/webhooks/reddit",
})

console.log(deployed.id)
```

**cURL**

```bash
curl -X POST https://api.pipedream.com/v1/connect/{project_id}/triggers/deploy \
  -H "Content-Type: application/json" \
  -H "X-PD-Environment: production" \
  -H "Authorization: Bearer {access_token}" \
  -d '{
    "external_user_id": "{external_user_id}",
    "id": "reddit-new-comments-on-a-post",
    "webhook_url": "https://example.com/webhooks/reddit",
    "configured_props": {
      "reddit": { "authProvisionId": "apn_xxxxxxx" },
      "timer": { "intervalSeconds": 900 },
      "subreddit": "Subreddit"
    }
  }'
```

**MCP**

MCP servers expose Reddit actions as on-demand tools.

New comments on a post is an event source, so your application deploys it with the Connect SDK or API and then either receives each event at a webhook URL or retrieves events on demand with the trigger events API.

## Event delivery

Every event is sent to the HTTP endpoint you choose when you deploy the source. Or: no webhook required — your app or agent can fetch recent events from the [trigger events API](https://pipedream.com/docs/connect/api-reference/list-trigger-events.md) instead.

---

- App: https://pipedream.com/apps/reddit.md · All apps: https://pipedream.com/apps