Reddit Posts

Create a new Reddit Post

post/api/reddit-posts

Request

  • Base URL: https://hellosafe.com
  • URL: https://hellosafe.com/api/reddit-posts
  • Auth: OAuth 2 (password, token URL /api//openapi-auth)

Query parameters

depthnumber
localestring

Request body

redditIdstring required

Reddit thing id (e.g. t3_abc123). Unique — the dedup / upsert key.

permalinkstring required

Full URL of the Reddit thread.

subredditstring required

Subreddit the post is in (without the r/ prefix).

titlestring required
postBodystring nullable

Snapshot of the post text, captured at discovery time (Reddit cannot be fetched live). May be stale — see lastFetchedAt.

postCreatedAtstring nullable

When the Reddit post was authored. (Not "createdAt" — that name is reserved by Payload.)

redditScorenumber nullable

Reddit upvotes — DISPLAY ONLY. Ranking is done by Claude at triage, not by this number.

numCommentsnumber nullable

Existing comment count — lets the skill deprioritise already-saturated threads.

matchedKeywordstring nullable

Which discovery keyword matched this thread.

discoveredAtstring nullable

When this lead first entered the queue. Set on create; the queue sorts by this.

lastFetchedAtstring nullable

When the snapshot (body + comments) was last captured. Surfaced as a staleness warning.

status'new' | 'drafted' | 'replied' | 'dismissed' required

new → drafted → replied (or dismissed). The open queue = "new".

ourReplystring nullable

The drafted / approved reply text (plain markdown — Reddit is not rich HTML).

replyPermalinkstring nullable

URL of the comment we actually posted. Captured at confirmation — makes replies auditable.

repliedAtstring nullable

When status was set to "replied".

repliedBystring

ID of the users

Response

Reddit Post object

messagestring required

Changes

No recorded changes to this operation across all 1 revision of this API.