Contents

API reference / Reddit

Plan a thread for a subreddit

POST /api/v1/projects/{project}/reddit/subreddits/{subreddit}/post

plan_reddit_post Write MCP tool

Builds a brief for starting a thread there (the rules that bind it, title options, an outline that defines the brand early, what to leave out) and, when an AI provider is set, writes the draft. The draft always discloses that you work on the brand, and the returned checks list what still needs a person. Not for communities whose rules ban self-promotion: it says so instead.

A full-access key (ss_sk_…), or an editor or owner signed in.

Parameters

NameTypeDescription
project required
path
string The project's id.
subreddit required
path
string The subreddit's id.

Request body

JSON, sent with Content-Type: application/json.

NameTypeDescription
kind string story (a post from the team), resource (a guide with data), comparison (an honest comparison) or feedback (asking for opinions). Default story.
One of: story resource comparison feedback
notes string
up to 2000 characters
What the thread should be about, in your words, and any real facts to use (numbers, dates, results).
draft boolean Write the draft as well as the brief (default true; needs an AI provider).

Returns

{ data: { item: Opportunity, brief, draft: { title, body } | null, checks, ai: boolean } }

Example

curl -X POST "https://sniffington.com/api/v1/projects/{project}/reddit/subreddits/{subreddit}/post" \
  -H "Authorization: Bearer $SCOUT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"kind":"story","notes":"…"}'