Reddit
Posts
Create Reddit posts through the shared posts API.
Publish to a Reddit subreddit through POST /v1/posts.
Cross-platform flow: Media guide. Helpers: Overview — Subreddits / Flairs.
Supported formats
mediaKind | Supported | Notes |
|---|---|---|
text | Yes | Self post when link omitted; link post when destinations[].link is set |
image | Yes | One image URL |
multi-image | Yes | 2–20 image URLs → gallery |
video | Yes | One video URL + required thumbnailUrl poster |
stories | No | UNSUPPORTED_MEDIA_KIND |
Features
| Feature | Supported | Notes |
|---|---|---|
| Thread / quote | No | |
| Schedule | Yes | scheduledFor + timezone |
| Title | Yes | Required destinations[].title (max 300) |
| Body | Yes | Post text → selftext (Markdown) |
| Subreddit | Yes | Required destinations[].subreddit (no r/ prefix) |
| Flair | Yes | Optional flairId / flairText |
| NSFW / spoiler | Yes | nsfw, spoiler booleans |
| Link | Yes | destinations[].link for link posts |
| Thumbnail | Yes | thumbnailUrl required for video |
| Remote delete | Yes | DELETE …/destinations/:id |
Required destination fields
{
"connectionId": "YOUR_REDDIT_CONNECTION_ID",
"title": "Hello from Onepostly",
"subreddit": "test"
}| Field | Required | Meaning |
|---|---|---|
title | Yes | Post title |
subreddit | Yes | Community name without r/ |
flairId | No | Link flair template id |
flairText | No | Editable flair text |
link | No | URL for link posts (mediaKind: "text") |
thumbnailUrl | Video only | Poster image URL |
nsfw / spoiler | No | Flags |
Create (self / text)
curl -X POST https://api.onepostly.com/v1/posts \
-H "x-api-key: op_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"text": "Optional markdown body.",
"mediaKind": "text",
"destinations": [
{
"connectionId": "YOUR_REDDIT_CONNECTION_ID",
"title": "Hello from Onepostly",
"subreddit": "test"
}
]
}'Create (link)
{
"text": "",
"mediaKind": "text",
"destinations": [
{
"connectionId": "YOUR_REDDIT_CONNECTION_ID",
"title": "Interesting article",
"subreddit": "test",
"link": "https://example.com/article"
}
]
}Create (image)
{
"text": "",
"mediaKind": "image",
"mediaUrls": ["https://cdn.example.com/photo.jpg"],
"destinations": [
{
"connectionId": "YOUR_REDDIT_CONNECTION_ID",
"title": "Product shot",
"subreddit": "test",
"flairId": "OPTIONAL_FLAIR_ID"
}
]
}Create (gallery / multi-image)
{
"mediaKind": "multi-image",
"mediaUrls": [
"https://cdn.example.com/1.jpg",
"https://cdn.example.com/2.jpg"
],
"destinations": [
{
"connectionId": "YOUR_REDDIT_CONNECTION_ID",
"title": "Album",
"subreddit": "test"
}
]
}Create (video)
{
"mediaKind": "video",
"mediaUrls": ["https://cdn.example.com/clip.mp4"],
"destinations": [
{
"connectionId": "YOUR_REDDIT_CONNECTION_ID",
"title": "Demo clip",
"subreddit": "test",
"thumbnailUrl": "https://cdn.example.com/poster.jpg"
}
]
}Remote delete
curl -X DELETE "https://api.onepostly.com/v1/posts/POST_ID/destinations/DEST_ID" \
-H "x-api-key: op_YOUR_KEY"