create_post
Create, schedule, or publish Patreon text posts via the web editor API using a session cookie; supports drafts, visibility tiers, tags, and teasers.
Instructions
Create a text post through Patreon's web editor API.
Requires PATREON_SESSION_COOKIE or PATREON_SESSION_COOKIE_FILE. This uses Patreon's undocumented browser API, not the official OAuth API, and can break when Patreon changes its web app. Only text posts are supported.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"title": "<title>"
},
"name": "create_post"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tags | No | Optional user-defined post tags. | |
| title | Yes | Post title. | |
| content | No | Post body as HTML or plain text. The web editor stores HTML. | |
| publish | No | false creates a draft; true publishes immediately or schedules when scheduled_for is set. | |
| tier_ids | No | Tier IDs allowed to view the post. Required when visibility='tiers'. | |
| allow_html | No | Publish raw HTML. Off by default: content and teaser are escaped as plain text. Raw HTML can include links, embeds, and tracking pixels. | |
| visibility | No | public = everyone; paid = all paying patrons; tiers = only the tier_ids listed. | paid |
| campaign_id | No | Campaign ID, used only to resolve tier_ids. Omit to use the web session's current campaign. | |
| teaser_text | No | Optional plain-text teaser shown before the paywall. | |
| scheduled_for | No | ISO 8601 publish time with timezone, for example 2026-10-20T18:00:00Z. Requires publish=true. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | ||
| url | No | ||
| title | No | ||
| content | No | ||
| is_paid | No | ||
| is_draft | No | ||
| tier_ids | No | ||
| edited_at | No | ||
| embed_url | No | ||
| is_public | No | ||
| post_type | No | ||
| app_status | No | ||
| created_at | No | ||
| embed_data | No | ||
| patreon_url | No | ||
| published_at | No | ||
| scheduled_for | No | ||
| access_rule_types | No | ||
| content_truncated | No | ||
| current_user_can_edit | No |