Reddit Settings

OpenQuok public API provider settings for Reddit — markdown body, optional subreddit and title, media for handoff; manual dashboard connect and awaiting-member due state.

2 min read

Connect your agent today

Draft from chat, review in your calendar, and publish only what you approve.

Start your free trial

Quick reference

Property	Value
Identifier	reddit
Connect	Dashboard manual channel — GET /api/v1/public/social/reddit returns 400
Setup guide	Reddit
Body cap	10,000 characters (markdown on top-level body)
Publish	No server publish — due rows move to awaiting member; you submit on reddit.com
Main-post media	Optional images via upload — stored for extension handoff download; not uploaded to Reddit by OpenQuok

Note

Add Reddit from Add Channel in the dashboard. The body is markdown on body. Optional subreddit and title live in providerSettingsByIntegrationId for autofill at handoff. OpenQuok does not call Reddit’s publish API.

Settings on create post

Flat keys and the reddit nested bucket are both accepted.

Flat CLI / API key	Nested composer bucket	Purpose
subreddit	reddit.subreddit	Community or profile (r/name or u/name) — optional for global-only captions
community / sub	—	Aliases for subreddit
title	reddit.title	reddit.com post title (1–300 chars when Settings are in use)

When any subreddit or title field is set, OpenQuok validates community and title before schedule. Global captions without Settings can omit both — you choose the subreddit when you paste on reddit.com.

{
  "providerSettingsByIntegrationId": {
    "<reddit-integration-id>": {
      "reddit": {
        "subreddit": "r/openquok",
        "title": "Weekly product update"
      }
    }
  }
}

Media for handoff

Attach uploads on the top-level media array (or per-channel media in customize mode). OpenQuok stores files for your workflow. At due time the optional browser extension can download attachments — OpenQuok does not upload them to Reddit.

{
  "body": "Screenshot walkthrough in markdown.",
  "integrationIds": ["<reddit-integration-id>"],
  "media": [{ "id": "<media-id>", "path": "FILE_PATH_FROM_UPLOAD" }],
  "providerSettingsByIntegrationId": {
    "<reddit-integration-id>": {
      "subreddit": "openquok",
      "title": "New feature screenshot"
    }
  }
}

Field reference

Field	Type	Required	Notes
subreddit / reddit.subreddit	string	When Settings active	Normalized to r/name or u/name
title / reddit.title	string	When Settings active	1–300 characters
Top-level body	string	Yes	Markdown caption — links allowed

Run GET /api/v1/public/integrations/:id/settings (or openquok integrations:settings) for the typed settingsSchema Reddit exposes.

Complete example

curl -X POST https://api.openquok.com/api/v1/public/posts 
  -H "Authorization: Bearer opo_your_programmatic_token" 
  -H "Content-Type: application/json" 
  -d '{
    "body": "**Markdown body** — finish this post on reddit.com when the row is awaiting member.",
    "scheduledAt": "2026-05-15T12:00:00.000Z",
    "status": "scheduled",
    "integrationIds": ["<reddit-integration-id>"],
    "isGlobal": true,
    "providerSettingsByIntegrationId": {
      "<reddit-integration-id>": {
        "reddit": {
          "subreddit": "r/openquok",
          "title": "Release notes from the API"
        }
      }
    }
  }'