Self posts
Text submissions — the first line becomes the title.
Reddit · Community
The Reddit API, submit without the boilerplate
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.
Self postsLink postsSubreddit-awareScheduling
Official OAuth APIup to 40,000 charsReddit API
publish-reddit.ts
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"]}'201 · { id: "9f2c8b1e…", status: "published" }JSON
Why not raw?
Reddit API is powerful — and painful
The official API can do this. It just makes you do a lot first. Here's what raw Reddit publishing costs you, and what PostMyIsh absorbs.
Raw Reddit API
With PostMyIsh
Request
Form-encoded /api/submit with a mandatory custom User-Agent
We set both; you send JSON
Auth
OAuth with the submit scope and app registration
One OAuth screen, one encrypted token
Rules
Per-subreddit rules, flair, and rate limits differ everywhere
Subreddit stored per account; limits surfaced
Errors
Errors hide in json.errors, not the HTTP status
We parse them and return a clear message
Capabilities
Everything Reddit supports, one endpoint
Post types, limits, and scheduling — all through the same POST /v1/posts call, formatted the way Reddit expects.
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.
Copy, paste, ship
Real calls, not pseudocode
Every snippet hits the live API — same base URL, Bearer auth, plain JSON. Add your key and it runs.
Publish to Reddit now
One POST fans out to Reddit. The response carries the id and status the moment it ships.
publish.txt
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"]}'How it works
Live in three steps, not three weeks
Connect Reddit, call one endpoint, and we run the Reddit API plumbing behind it.
Step 01
Connect the account
Link it once from the Accounts page through its official login. The credential is stored encrypted.
Step 02
POST /v1/posts
Send one caption and the platform id. Add schedule_at to queue it, or media for a URL.
Step 03
We handle the rest
Container flows, token refresh, rate limits, and the real post id — all on our side.
Straight talk: Reddit requires a registered app, the submit scope, and a compliant User-Agent — all handled. Mind per-subreddit rules and rate limits; those are set by each community.
Reddit API FAQ
The honest answers
What's real, what needs review, and what Reddit itself requires — no hand-waving.
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.
Ready to post your ish everywhere?
Connect your accounts, write one caption, and be live on every feed in minutes. The free plan is genuinely free.