Overview

Onepostly maps Reddit into the same /v1/* surface as other platforms. This section covers Reddit-only behavior.

In this section

Page	Topics
Posts	Text, link, image, gallery, video; title / subreddit / flair; schedule; remote delete
Insights	Score, upvote ratio, comment count

Cross-platform API flow: Media, Webhooks.

Connect

Dashboard → Connections → connect Reddit
Approve scopes in the Reddit consent screen
Resolve connectionId with your API key:

curl https://api.onepostly.com/v1/connections \
  -H "x-api-key: op_YOUR_KEY"

Use the matching row’s id (where platform is "reddit") as connectionId.

After OAuth, connection metadata includes:

Field	Meaning
`username`	Reddit username

Subreddits API

Every post targets a community. List communities the connected account is subscribed to:

curl https://api.onepostly.com/v1/connections/CONNECTION_ID/reddit/subreddits \
  -H "x-api-key: op_YOUR_KEY"

{
  "connectionId": "…",
  "platform": "reddit",
  "subreddits": [
    {
      "name": "test",
      "title": "testing",
      "subscribers": 12345,
      "nsfw": false,
      "iconUrl": null
    }
  ],
  "fetchedAt": "…"
}

Flairs API

Many communities require link flair. List templates:

curl https://api.onepostly.com/v1/connections/CONNECTION_ID/reddit/subreddits/test/flairs \
  -H "x-api-key: op_YOUR_KEY"

{
  "connectionId": "…",
  "platform": "reddit",
  "subreddit": "test",
  "flairs": [{ "id": "…", "text": "Discussion", "textEditable": false }],
  "fetchedAt": "…"
}

Pass the chosen id as destinations[].flairId when creating a post.

OAuth scopes

Scope	Used for
`identity`	Profile
`submit`	Create posts
`read`	Comments / listings / insights
`mysubreddits`	Subscribed communities
`edit`	Delete own posts / comments
`history`	History access
`vote`	Upvote / clear vote (like)
`save`	Save / unsave (bookmark)
`flair`	Assign link flair

OAuth 2.0 authorization code. Connected accounts stay usable while refresh tokens remain valid.

{API}/v1/connections/oauth/reddit/callback

Capabilities

Action	Supported	Notes
Create post	Yes	`POST /v1/posts`
Text-only (self)	Yes	`mediaKind: "text"` without `link`
Link	Yes	`mediaKind: "text"` + `destinations[].link`
Image	Yes
Multi-image	Yes	Gallery, 2–20 images
Video	Yes	Requires `destinations[].thumbnailUrl` poster
Stories / thread / quote	No
Schedule	Yes	`scheduledFor` + `timezone`
Remote delete	Yes	`DELETE …/destinations/:id`
Comments	Yes	List / create / delete
Like / unlike	Yes	Maps to upvote / clear vote
Bookmark	Yes	Save / unsave
Insights	Yes	Score, comment count, upvote ratio (no impressions/reach)

Known limitations

destinations[].title and destinations[].subreddit are required
Subreddit rules (karma, age, flair) are enforced by Reddit — failed submits surface as publish errors
Video posts need a separate poster image URL (thumbnailUrl)
Reddit API access may require Reddit’s commercial / Data Access approval