Patreon icon

Patreon

Consume Patreon API

Overview

This node interacts with the Patreon API to retrieve all members of a specified campaign. It is useful for automating workflows that require access to supporter/member data from Patreon campaigns, such as syncing member lists to CRMs, sending custom emails to patrons, or analyzing patron demographics.

Example scenarios:

  • Exporting all members of a Patreon campaign to a Google Sheet.
  • Sending personalized thank-you messages to new patrons.
  • Integrating Patreon membership data with other marketing or analytics tools.

Properties

Name Type Meaning
Campaign ID String Patreon campaign ID. This identifies which campaign's members will be retrieved. Required field.

Output

The output is an array of JSON objects, each representing a member of the specified Patreon campaign. Each object contains detailed information about the member and their associated tiers and address (if available). The structure includes:

  • Member fields:

    • full_name: The full name of the member.
    • is_follower: Whether the user is a follower but not a paying patron.
    • last_charge_date: Date of the last charge attempt.
    • last_charge_status: Status of the last charge (e.g., Paid, Declined).
    • lifetime_support_cents: Total amount supported in cents.
    • currently_entitled_amount_cents: Current monthly pledge in cents.
    • patron_status: Patron status (e.g., active_patron, former_patron).
  • Tier fields (if included):

    • amount_cents, created_at, description, discord_role_ids, edited_at, patron_count, published, published_at, requires_shipping, title, url.
  • Address fields (if included):

    • addressee, city, line_1, line_2, phone_number, postal_code, state.

Example output:

[
  {
    "id": "123456",
    "type": "member",
    "attributes": {
      "full_name": "Jane Doe",
      "is_follower": false,
      "last_charge_date": "2024-05-01T00:00:00.000+00:00",
      "last_charge_status": "Paid",
      "lifetime_support_cents": 5000,
      "currently_entitled_amount_cents": 1000,
      "patron_status": "active_patron"
    },
    "relationships": {
      "currently_entitled_tiers": [ ... ],
      "address": { ... }
    }
  }
]

Dependencies

  • External Service: Requires access to the Patreon API.
  • Authentication: Needs a valid OAuth2 credential (patreonOAuth2Api) configured in n8n.
  • Environment: No special environment variables required beyond standard n8n OAuth2 setup.

Troubleshooting

  • Common Issues:

    • Invalid Campaign ID: If the provided Campaign ID is incorrect or does not exist, the node may return an error or empty results.
    • Insufficient Permissions: The connected Patreon account must have permission to access the specified campaign's member data.
    • API Rate Limits: Excessive requests may trigger rate limiting by Patreon.
  • Error Messages:

    • "Request failed with status code 404": The Campaign ID is invalid or inaccessible. Double-check the Campaign ID.
    • "401 Unauthorized": OAuth2 credentials are missing or expired. Reconnect your Patreon account in n8n.
    • "Missing required parameter: value": The Campaign ID property is empty. Ensure you provide a valid Campaign ID.

Links and References

Discussion