Posts are either link (with URL/media), native video (via nativeVideo), or self (text-only). Use forceSelf to override. Subreddit defaults to the account's configured one. Some subreddits require a flair.
| Name | Type | Description | Notes |
|---|---|---|---|
| subreddit | String | Target subreddit name (without "r/" prefix). Overrides the default. Use GET /v1/accounts/{id}/reddit-subreddits to list options. | [optional] |
| title | String | Post title. Defaults to the first line of content, truncated to 300 characters. | [optional] |
| url | URI | URL for link posts. If provided (and forceSelf is not true), creates a link post instead of a text post. | [optional] |
| forceSelf | Boolean | When true, creates a text/self post even when a URL or media is provided. | [optional] |
| flairId | String | Flair ID for the post. Required by some subreddits. Use GET /v1/accounts/{id}/reddit-flairs?subreddit=name to list flairs. | [optional] |
| flairText | String | Custom flair text, for subreddits that allow free-text flair. Ignored when flairId is provided (flairId wins). | [optional] |
| nsfw | Boolean | Mark the post as NSFW (Not Safe For Work / over 18). | [optional] |
| spoiler | Boolean | Mark the post as a spoiler. The subreddit must have spoiler tagging enabled for this to take effect. | [optional] |
| sendreplies | Boolean | Whether to receive inbox replies for comments on this post. Set to false to opt out. | [optional] |
| nativeVideo | Boolean | Controls Reddit's native video upload flow. When true (default for video mediaItems), the video is uploaded to Reddit's CDN and submitted with kind=video so it renders as an embedded Reddit video player. Reddit transcodes server-side (1080p/30fps cap). Set to false to fall back to a legacy link post. If the subreddit blocks video posts, the upload falls back to a link post automatically. | [optional] |
| videogif | Boolean | When true (and nativeVideo is active), submits the video as a silent videogif (kind=videogif). Use for short looping clips without audio. | [optional] |
| videoPosterUrl | URI | Optional poster/thumbnail image URL for native video posts. If omitted, the first frame of the video is extracted and used automatically. | [optional] |