Overview

Creates a new post to your Reddit profile (not a subreddit) using Reddit's Shreddit GraphQL API. Supports markdown-formatted text content.

Inputs

| Field | Type | Required | Description | |-------|------|----------|-------------| | title | string | ✅ | Post title (max 300 characters) | | markdown_content | string | ✅ | Body content in markdown format |

Response

Returns the full GraphQL response body with the created post data:

{
  "data": {
    "submitPost": {
      "post": {
        "id": "t3_abc123",
        "title": "Your post title",
        "permalink": "/user/your_username/comments/abc123/your_post_title/",
        "createdAt": "2025-01-15T10:30:00.000Z"
      }
    }
  }
}

Error scenarios:

Missing CSRF token → 400 error
Invalid reCAPTCHA → rejection
Empty title/content → validation error
Rate limited → 429 response

Auth & browser

Requires logged-in browser session. This endpoint requires an active Reddit session with:

Valid csrf_token cookie (auto-extracted)
reCAPTCHA token generation (auto-handled via browser)

Examples

Request inputs:

{
  "title": "My automation journey",
  "markdown_content": "Today I automated my workflow using Apificial..."
}

Success response:

{
  "data": {
    "submitPost": {
      "post": {
        "id": "t3_abc123",
        "title": "My automation journey",
        "permalink": "/user/johndoe/comments/abc123/my_automation_journey/"
      }
    }
  }
}

Notes

Posts appear on your Reddit profile (reddit.com/user/your_username)
Content is formatted as rich text (Reddit's internal format) from markdown
First calls validate-create-post internally for pre-validation
NSFW and spoiler flags are set to false by default
reCAPTCHA action is postsubmitprofile
Correlation ID is auto-generated for tracking
Rate limiting applies — Reddit may temporarily block rapid posting
Posts are public by default (to your profile feed)
For posting to a specific subreddit, use create-subreddit-post instead