Take in a Patreon membership message
/api/supporters/patreonPatreon calls this when a membership is made, changed or deleted, and when a charge goes through or fails. The body is signed with the webhook secret from Patreon (hex HMAC-MD5 in X-Patreon-Signature); a message with no signature or the wrong one is refused (401) and nothing is read. An active patron with a tier gets that tier's roles; a patron whose charge was declined keeps them until the Patreon setting's number of days after the charge; a pledge that ended keeps them until the paid month is up and that number of days more (or for good, when the setting is never). Anything else is answered 200 and ignored. Answers 404 while Patreon is off or no secret is saved.
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X POST "https://example.com/api/supporters/patreon"Take in a Ko-fi payment POST
Ko-fi calls this when somebody pays. The message carries the verification token from Ko-fi's webhook page; one that does not match the token saved in Settings is refused (401). A monthly payment with a tier name counts; anything else is answered 200 and ignored. The same payment twice counts once. Answers 404 while Ko-fi is off or no token is saved.
List supporters and tiers GET
The tiers with the roles each gives, and the supporters with the newest payment first (at most 500). A supporter with no `discordUserId` has not been matched to a Discord account yet. Needs the `ManageSettings` permission.