Using Reddit with Schedulin

Schedulin posts to Reddit via the official OAuth API. You can schedule text, link, image, video, and gallery posts to any subreddit you're allowed to post to.

Connecting Reddit

1. On Schedulin's Channels page, click Connect Reddit.
2. You'll be sent to Reddit's consent screen. Approve the scopes — Schedulin needs identity, submit, read, edit, history, flair, and modposts.
3. After consent, Reddit returns you to Schedulin and the account appears in your channel list.

The connection uses Reddit's permanent refresh-token flow, so once connected you won't need to re-authenticate unless you revoke access from Reddit's authorized applications page.

What you can publish

If you attach a single image, we submit as an image post. Two or more images becomes a gallery. A video plus an image uses the image as the video poster.

Required fields

Every Reddit post needs:

• Title — up to 300 characters. Shown as the post headline.
• Subreddit — pick from the autocomplete; we strip the r/ prefix automatically.

Optional:

• Flair — appears in the composer once a subreddit is chosen, if that subreddit has flairs configured.
• Link URL — for link posts. Ignored if you also attach media.
• NSFW, Spoiler, Send reply notifications — toggles in the composer.

Validation we run before submit

Schedulin catches the obvious errors before they reach Reddit:

• Title required, ≤ 300 chars.
• Subreddit required, non-empty.
• Body ≤ 5,000 chars (Schedulin's general API cap; Reddit itself allows up to 40k).
• Gallery limited to 20 images.

What we can't pre-validate (Reddit's automod enforces these async):

• Subreddit-specific title format rules (e.g. r/AskReddit requires a question mark).
• Banned link domains.
• Flair-required subs without a flair.
• Approved-poster-only subs.

If Reddit rejects the post for one of these, the post fails with Reddit's exact error message visible in the post detail view.

Analytics

We poll Reddit's API for each published post on a back-off schedule (every 5 min for the first hour, then progressively slower out to 30 days). For each post we track:

• Score — Reddit's upvotes minus downvotes
• Comments — total comment count
• Views — when Reddit makes it available (view_count is often null for newer posts)

Known limitations

• No live subreddit-rule preflight. We surface Reddit's error after the fact.
• Flair picker shows nothing if the subreddit has no flairs configured or you're not approved to see them — both look the same from the API.
• DMs and modmail are not supported in scheduling yet.
• Per-OAuth rate limit is 60 requests/minute. Heavy autocomplete typing will throttle.

Troubleshooting

"SUBREDDIT_NOEXIST" — the subreddit name is misspelled or the sub was banned.

"SUBMIT_VALIDATION_FLAIR_REQUIRED" — the subreddit requires a flair on every post. Pick one from the flair dropdown.

"POST_GUIDANCE_VALIDATION_FAILED" — the subreddit has a custom rule (title format, body length, etc.). The error message will include the specific rule.

Post succeeded but got removed minutes later — Reddit's automod or a moderator removed it after submission. Schedulin can't prevent this; check the post on Reddit to see the removal reason.

Connection broken with "REFRESH_FAILED" — you (or a co-owner) revoked Schedulin from Reddit's authorized applications page. Reconnect via Channels.