Platform guide · Community
Submit self posts and links to a subreddit with the official OAuth API. We handle the form encoding and the required User-Agent — you send a title and body.
At a glance
| API | Reddit API |
| Connection | OAuth — supply an access token |
| Formats | Image, Video, Text |
| Character limit | 40,000 |
| Media | Text-first; media optional |
Connect Reddit
Reddit connects over OAuth. Complete the network’s OAuth to mint an access token, then connect Reddit from the dashboard’s Accounts page. These are the fields it needs:
| Field | Send as | Required | Where to find it |
|---|---|---|---|
| Access tokensecret | accessToken | Required | OAuth submit scope |
| Subreddit | subreddit | Required | Without the r/ prefix |
Everything marked secret is sealed with AES-256-GCM before storage — see Connecting accounts.
Publish to Reddit
Once connected, Reddit is just another id in your platforms array. One call publishes:
curl https://postmyish.com/api/v1/posts \
-H "Authorization: Bearer $POSTMYISH_KEY" \
-H "Content-Type: application/json" \
-d '{"caption":"We built an open-source alternative — here's why","platforms":["reddit"]}'The same request can fan out to X, Discord and more — add their ids to the array. See Publish everywhere at once.
What you can do
- Self posts. Text submissions — the first line becomes the title.
- Link posts. Pass media as a URL and it submits as a link post.
- Subreddit targeting. Set the subreddit once; submits go there by default.
- Fan-out. Announce to Reddit, X, and Discord in one call.
Setup & review
FAQ
Is this the official Reddit API?
Yes — the OAuth /api/submit endpoint with the submit scope and a compliant User-Agent.
Self post or link post?
No media means a self (text) post; pass media as a URL and it submits as a link post.
Which subreddit?
The one you set when connecting. Watch each subreddit's own rules and rate limits — those are Reddit's, per community.
Can I schedule?
Yes — schedule_at queues the submit and we send it when due.