Negotiable Paleobotanist Missions
    Have ideas to improve npm?Join in the discussion! »


    0.4.2 • Public • Published


    Build State

    Use the Patreon API via OAuth.


    You'll need to register an OAuth client account to receive a client_id, client_secret and other info for use with this module.

    Visit the OAuth Documentation Page while logged in as a Patreon creator on to register your client.


    Install with npm. You'll need to have Node.js installed.

    npm install --save patreon


    When you see 'pppp' replace pppp with the data you received setting up your OAuth account or otherwise suggested by the inline comments.

    var url = require('url')
    var patreon = require('patreon')
    var patreonAPI = patreon.patreon
    var patreonOAuth = patreon.oauth
    // Use the client id and secret you received when setting up your OAuth account
    var CLIENT_ID = 'pppp'
    var CLIENT_SECRET = 'pppp'
    var patreonOAuthClient = patreonOAuth(CLIENT_ID, CLIENT_SECRET)
    // This should be one of the fully qualified redirect_uri you used when setting up your oauth account
    var redirectURL = ''
    function handleOAuthRedirectRequest(request, response) {
        var oauthGrantCode = url.parse(request.url, true).query.code
            .getTokens(oauthGrantCode, redirectURL)
            .then(function(tokensResponse) {
                var patreonAPIClient = patreonAPI(tokensResponse.access_token)
                return patreonAPIClient('/current_user')
            .then(function(result) {
                var store =
                // store is a [JsonApiDataStore](
                // You can also ask for result.rawJson if you'd like to work with unparsed data
                response.end(store.findAll('user').map(user => user.serialize()))
            .catch(function(err) {
                console.error('error!', err)

    If you're using babel or writing es2015 code:

    import url from 'url'
    import { patreon as patreonAPI , oauth as patreonOAuth } from 'patreon'
    const CLIENT_ID = 'pppp'
    const CLIENT_SECRET = 'pppp'
    const patreonOAuthClient = patreonOAuth(CLIENT_ID, CLIENT_SECRET)
    const redirectURL = ''
    function handleOAuthRedirectRequest(request, response) {
        const oauthGrantCode = url.parse(request.url, true).query.code
            .getTokens(oauthGrantCode, redirectURL)
            .then(tokensResponse => {
                const patreonAPIClient = patreonAPI(tokensResponse.access_token)
                return patreonAPIClient('/current_user')
            .then(({ store }) => {
                // store is a [JsonApiDataStore](
                // You can also ask for result.rawJson if you'd like to work with unparsed data
                response.end(store.findAll('user').map(user => user.serialize()))
            .catch(err => {
                console.error('error!', err)

    You can also reference the included server example.


    var patreonOAuthClient = oauth(clientId, clientSecret)

    Returns an object containing functions for fetching OAuth access tokens.

    clientId The client id you received after setting up your OAuth account. clientSecret The client secret you received after setting up your OAuth account.

    patreonOAuthClient.getTokens(redirectCode, redirectUri)

    This makes a request to grab tokens needed for making API requests, and returns a promise.

    redirectCode Use the code query param provided to your OAauth redirect route. redirectUri This should be the same redirect route you provided in the initial auth request.

    The promise will be resolved with the parsed JSON containing a tokens response object, or will be rejected with an error message.

    The tokens object will look something like this:

        access_token: 'access_token',
        refresh_token: 'refresh_token',
        expires_in: 'time_window',
        scope: 'users pledges-to-me my-campaign',
        token_type: 'Bearer'

    You must pass tokens.access_token in to patreon for making API calls.

    var client = patreon(accessToken)

    Returns a function for making authenticated API calls.


    Returns a promise representing the result of the API call.

    pathname API resource path like /current_user.

    If the API call is successful, the promise will resolve with an object containing three pieces:

    • store: a JsonApiDataStore. This provides a nice, usable wrapper around the raw JSON:API response to easily access related resources and resource attributes.
    • rawJson: a JSON object in the JSON:API format, for advanced custom usage (say, parsing into your own JSON:API data store)
    • response: the actual fetch Response object, for the lowest level of response analysis

    If the API call is unsuccessful, the promise will reject with an error.

    API Resources


    /current_user /current_user/campaigns /campaigns/${campaign_id}/pledges

    Response Format

    You can request specific related resources and or resource attributes that you want returned by our API, as per the JSON:API specification. The lists of valid includes and fields arguments are provided in patreon/schemas. For instance, if you wanted to request the total amount a patron has ever paid to your campaign, which is not included by default, you could do:

    const { patreon, jsonApiURL } = require('patreon')
    const pledge_schema = require('patreon/schemas/pledge')
    const patreonAPIClient = patreon(access_token)
    const url = jsonApiURL(`/current_user`, {
      fields: {
        pledge: [...pledge_schema.default_attributes, pledge_schema.attributes.total_historical_amount_cents]
    patreonAPIClient(url, callback)


    Having additional scopes

    The Patreon JS library uses a data store pattern for storing inflated objects from the returned results of API calls. In some cases, especially if you have been granted the scopes for being a multi-campaign client or are opted-in to some API beta programs, the JS client calling /current_user will fetch the current user's campaign, as well as all the patron users connected to that campaign.

    This can result in the user store in the JS library having a larger list of users than expected for a call to /current_user, but the current user's user object will be in that list.

    Example for finding the actual current user:

    var patreon_response = patreon_client('/current_user').then(function(result) {
        user_store =
        let data = result.rawJson
        const myUserId =
        creator = user_store.find('user', myUserId)



    npm i @getvokl/patreon

    DownloadsWeekly Downloads






    Unpacked Size

    43.1 kB

    Total Files


    Last publish


    • avatar