Patreon API

POST https://cotlet.dev/api/v1/patreon/list_tiers

Returns every tier on your Patreon page. Use the tier_id of each item in the other endpoints. Benefits are the ones shown in the tier editor.

Parameters

No parameters.

Request

curl -X POST https://cotlet.dev/api/v1/patreon/list_tiers \
  -H "Authorization: Bearer $COTLET_API_KEY"

result = client.call("patreon", "list_tiers")

const result = await cotlet.call('patreon', 'list_tiers');

cotlet call patreon list_tiers

Example response

{
  "tiers": [
    {
      "tier_id": "24019876",
      "name": "Gold",
      "description": "Everything in Supporter plus early episodes.",
      "benefits": [
        "Episodes a week before release",
        "Monthly Q&A"
      ]
    }
  ]
}

POST https://cotlet.dev/api/v1/patreon/list_members

Lists members the way the Relationship manager does. Filter by paid or free, active or canceled, tier or join date. Pass next_cursor back as cursor for the next page.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/patreon/list_members \
  -H "Authorization: Bearer $COTLET_API_KEY"

result = client.call("patreon", "list_members")

const result = await cotlet.call('patreon', 'list_members');

cotlet call patreon list_members

Example response

{
  "members": [
    {
      "member_id": "m_4471920",
      "name": "Maya Fischer",
      "tier": "Gold",
      "status": "active",
      "paid": true,
      "joined_at": "2026-10-08T10:12:00Z"
    }
  ],
  "next_cursor": "eyJvZmZzZXQiOjUwfQ"
}

POST https://cotlet.dev/api/v1/patreon/export_members

Runs the same CSV export as the button in the Relationship manager, with the filters you pass. The file has the columns you chose in the table settings, plus Charge frequency if you offer annual memberships. It reaches no one and changes nothing.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/patreon/export_members \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"paid":"paid","status":"active"}'

result = client.call("patreon", "export_members", {"paid":"paid","status":"active"})

const result = await cotlet.call('patreon', 'export_members', {"paid":"paid","status":"active"});

cotlet call patreon export_members --data '{"paid":"paid","status":"active"}'

Example response

{
  "file_url": "https://cotlet.dev/api/v1/files/exports/patreon-members-2026-10-11.csv",
  "rows": 214,
  "filters": {
    "status": "active",
    "tier_id": "24019876"
  }
}

POST https://cotlet.dev/api/v1/patreon/list_posts

Lists your posts. Scheduled posts come first, labeled with their date, as in the Patreon post list. Body is a short preview; get_post returns the full text.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/patreon/list_posts \
  -H "Authorization: Bearer $COTLET_API_KEY"

result = client.call("patreon", "list_posts")

const result = await cotlet.call('patreon', 'list_posts');

cotlet call patreon list_posts

Example response

{
  "posts": [
    {
      "post_id": "118204553",
      "title": "Episode 12: the full cut",
      "status": "scheduled",
      "publish_at": "2026-10-16T18:00:00+01:00",
      "audience": "paid_tiers",
      "preview": "This week we go behind the scenes..."
    }
  ],
  "next_cursor": null
}

POST https://cotlet.dev/api/v1/patreon/get_post

Returns one post with its full body and the tiers that can see it. Use it before update_post to see what is there now.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/patreon/get_post \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"post_id":"post_8c41d2"}'

result = client.call("patreon", "get_post", {"post_id":"post_8c41d2"})

const result = await cotlet.call('patreon', 'get_post', {"post_id":"post_8c41d2"});

cotlet call patreon get_post --data '{"post_id":"post_8c41d2"}'

Example response

{
  "post_id": "118204553",
  "title": "Episode 12: the full cut",
  "body": "This week we go behind the scenes...",
  "status": "scheduled",
  "publish_at": "2026-10-16T18:00:00+01:00",
  "tier_ids": [
    "24019876"
  ],
  "url": "https://www.patreon.com/posts/episode-12-118204553"
}

POST https://cotlet.dev/api/v1/patreon/list_chats

Lists your Chats, most recent first, with the member, the last message and whether you sent it. Set unanswered_only to see what needs a reply.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/patreon/list_chats \
  -H "Authorization: Bearer $COTLET_API_KEY"

result = client.call("patreon", "list_chats")

const result = await cotlet.call('patreon', 'list_chats');

cotlet call patreon list_chats

Example response

{
  "chats": [
    {
      "member_id": "m_4471920",
      "name": "Maya Fischer",
      "last_message": "Where do I find the Q3 files?",
      "last_from": "member",
      "updated_at": "2026-10-10T16:02:00Z"
    }
  ],
  "next_cursor": null
}

POST https://cotlet.dev/api/v1/patreon/create_post

Creates a draft in your Patreon post list. Nobody sees it until publish_post or schedule_post. create_post runs without asking first: it reaches no one and a draft is removed with one call in Patreon.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/patreon/create_post \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"title","body":"body"}'

result = client.call("patreon", "create_post", {"title":"title","body":"body"})

const result = await cotlet.call('patreon', 'create_post', {"title":"title","body":"body"});

cotlet call patreon create_post --data '{"title":"title","body":"body"}'

Example response

{
  "post_id": "118204553",
  "status": "draft",
  "audience": "paid_tiers",
  "tier_ids": [
    "24019876"
  ],
  "title": "Episode 12: the full cut"
}

POST https://cotlet.dev/api/v1/patreon/update_post

Edits a post that is not published yet, as you would in the post editor. It reaches no one until the post goes out, so it runs without asking first. Published posts are not changed.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/patreon/update_post \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"post_id":"post_8c41d2","fields":"fields"}'

result = client.call("patreon", "update_post", {"post_id":"post_8c41d2","fields":"fields"})

const result = await cotlet.call('patreon', 'update_post', {"post_id":"post_8c41d2","fields":"fields"});

cotlet call patreon update_post --data '{"post_id":"post_8c41d2","fields":"fields"}'

Example response

{
  "post_id": "118204553",
  "status": "draft",
  "title": "Episode 12: the director's cut"
}

POST https://cotlet.dev/api/v1/patreon/schedule_post

Schedules a draft, which then shows at the top of your post list labeled Scheduled. Set notify_members to false to switch off the member notification for this post. By default you confirm each call; you can switch that off for this tool.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/patreon/schedule_post \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"post_id":"118204553","publish_at":"2026-10-16T18:00:00+01:00","notify_members":true}'

result = client.call("patreon", "schedule_post", {"post_id":"118204553","publish_at":"2026-10-16T18:00:00+01:00","notify_members":True})

const result = await cotlet.call('patreon', 'schedule_post', {"post_id":"118204553","publish_at":"2026-10-16T18:00:00+01:00","notify_members":true});

cotlet call patreon schedule_post --data '{"post_id":"118204553","publish_at":"2026-10-16T18:00:00+01:00","notify_members":true}'

Example response

{
  "post_id": "118204553",
  "status": "scheduled",
  "publish_at": "2026-10-16T18:00:00+01:00",
  "audience": "paid_tiers",
  "tier_ids": [
    "24019876"
  ],
  "url": "https://www.patreon.com/posts/episode-12-118204553"
}

POST https://cotlet.dev/api/v1/patreon/publish_post

Publishes a draft immediately to its audience. Members are notified unless notify_members is false. By default you confirm each call; you can switch that off for this tool.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/patreon/publish_post \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"post_id":"post_8c41d2"}'

result = client.call("patreon", "publish_post", {"post_id":"post_8c41d2"})

const result = await cotlet.call('patreon', 'publish_post', {"post_id":"post_8c41d2"});

cotlet call patreon publish_post --data '{"post_id":"post_8c41d2"}'

Example response

{
  "post_id": "118204553",
  "status": "published",
  "url": "https://www.patreon.com/posts/episode-12-118204553"
}

POST https://cotlet.dev/api/v1/patreon/send_message

Sends a direct message to one member in Chats. Patreon allows direct messages only to current or former paid members, so a free member returns an error. By default you confirm each call; you can switch that off for this tool.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/patreon/send_message \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"member_id":"m_4471920","body":"Hi Maya, the Q3 files are in the Q3 collection, third post from the top."}'

result = client.call("patreon", "send_message", {"member_id":"m_4471920","body":"Hi Maya, the Q3 files are in the Q3 collection, third post from the top."})

const result = await cotlet.call('patreon', 'send_message', {"member_id":"m_4471920","body":"Hi Maya, the Q3 files are in the Q3 collection, third post from the top."});

cotlet call patreon send_message --data '{"member_id":"m_4471920","body":"Hi Maya, the Q3 files are in the Q3 collection, third post from the top."}'

Example response

{
  "member_id": "m_4471920",
  "status": "sent",
  "sent_at": "2026-10-11T09:05:00+02:00"
}

POST https://cotlet.dev/api/v1/patreon/message_tier

Sends one message to the members of the tiers you name, as the Relationship manager does when you filter by tier. Only paid members can be messaged. By default you confirm each call; you can switch that off for this tool.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/patreon/message_tier \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tier_ids":["24019876","24019877"],"body":"Your October pack is ready: https://example.com/october-pack. Thanks for being here!"}'

result = client.call("patreon", "message_tier", {"tier_ids":["24019876","24019877"],"body":"Your October pack is ready: https://example.com/october-pack. Thanks for being here!"})

const result = await cotlet.call('patreon', 'message_tier', {"tier_ids":["24019876","24019877"],"body":"Your October pack is ready: https://example.com/october-pack. Thanks for being here!"});

cotlet call patreon message_tier --data '{"tier_ids":["24019876","24019877"],"body":"Your October pack is ready: https://example.com/october-pack. Thanks for being here!"}'

Example response

{
  "tier_ids": [
    "24019876"
  ],
  "status": "sent",
  "recipients": 214
}

POST https://cotlet.dev/api/v1/patreon/update_tier

Edits the fields at the top of the tier editor: name, description and benefits. Members see the change on your page. Prices are not changed by this tool. By default you confirm each call; you can switch that off for this tool.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/patreon/update_tier \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tier_id":"tier_8c41d2","fields":"fields"}'

result = client.call("patreon", "update_tier", {"tier_id":"tier_8c41d2","fields":"fields"})

const result = await cotlet.call('patreon', 'update_tier', {"tier_id":"tier_8c41d2","fields":"fields"});

cotlet call patreon update_tier --data '{"tier_id":"tier_8c41d2","fields":"fields"}'

Example response

{
  "tier_id": "24019876",
  "name": "Gold",
  "benefits": [
    "Episodes a week before release",
    "Monthly Q&A",
    "Monthly Q&A call"
  ],
  "status": "updated"
}