Overview

Creates a new post in a specified subreddit. This endpoint validates the post content and handles reCAPTCHA verification automatically before publishing.

Inputs

| Field | Type | Required | Description | |-------|------|----------|-------------| | title | string | Yes | The title of your post (max 300 characters) | | markdowncontent | string | Yes | The body content of your post in markdown format | | subredditname | string | No | Target subreddit name (default: WebScrapingInsider) |

Response

Returns the GraphQL mutation response from Reddit containing:

data - Post creation result with post ID and URL
errors - Array of validation errors if any

Success response includes:

{
  "data": {
    "createPost": {
      "post": {
        "id": "t3_xxxxx",
        "url": "/r/subreddit/comments/xxxxx/title/"
      }
    }
  }
}

Auth & browser

Requires authentication: Yes (uses browser session cookies)
useContext: Enabled - shares cookies with authenticated Reddit session
This endpoint requires you to be logged into Reddit in the browser context

Examples

Create a post in the WebScrapingInsider subreddit:

{
  "title": "New scraping technique discovered",
  "markdown_content": "Here's a guide to scraping dynamic content...",
  "subreddit_name": "WebScrapingInsider"
}

Create a post in a different subreddit:

{
  "title": "My question about APIs",
  "markdown_content": "Can anyone help with...",
  "subreddit_name": "AskReddit"
}

Notes

Rate limiting: Reddit enforces rate limits on post creation
Validation: Posts are validated via graphql-validate-create-post before creation
reCAPTCHA: Handled automatically using the site's reCAPTCHA enterprise token
NSFW/Spoiler flags: Set to false by default
Empty content: Title and content must not be empty
Subreddit permissions: You must have permission to post in the target subreddit