Patreon

Conventions

• {{BASE_URL}}: The website's base URL without a trailing slash, such as https://leicmin.mfgames.com

For Creators

To link Patreon tiers to Leicmin groups, you need to register Leicmin as a client. This has to be done for each Patreon account.

• Log into Patreon as a Creator.
• Go to https://www.patreon.com/portal/registration/register-clients.
• Click “Create Client”.
• Fill in the form:
• App Name: You should probably put something with “Leicmin” or the name of your website, this is mostly a label for viewing accounts and figuring out the purpose of the client.
• Description: Decribe the purpose of the account. Again, this is mostly for your purposes.
• App Category: Probably “Member Benefits” or “Content Management”.
• Redirect URIs: A space-separate list of links (though space separation doesn't seem to work). Put in {{BASE_URL}} plus /account/patreon such as https://leicmin.example.org/account/patreon.
• Client API Version: 2
• Click “Create”
• The modal will close and the “App Name” you selected will be in the list below, click on down arrow. There will be a number of fields that you need to copy and put into Lecimin:
• Client Secret
• Creator's Access Token
• Creator's Refresh Token

Once everything is copied over, these are the commands to run:

# Set the access token on the account.
leicmin account set --account-name "${ACCOUNT_NAME}" --patreon-creator-access-token "${PATREON_CREATOR_ACCESS_TOKEN}"

# Sync with Patreon to download the campaigns, tiers, users, and memberships.
leicmin account patreon sync --account-name "${ACCOUNT_NAME}"

# Create a group for each tier.
leicmin group add --account-name "${ACCOUNT_NAME}" --group-name "${GROUP_NAME}"

# Link the tier to the group.
leicmin account patreon tier set --account-name "${ACCOUNT_NAME}" --tier-name "${TIER_NAME}" --group-name "${GROUP_NAME}"