Use Kindful for Oauth/SSO

Grant Kindful user's access to your application using their Kindful login details

Gaining Access to this feature

Based upon your Kindful subscription, you may request access to Kindful for authenticating contacts into your third party membership portal using Kindful's oauth. Please request access through this link:

Someone will get back with you shortly, within 2 business days. If your account includes access to this feature, you will be instructed how to create a "Developer Account".

The Kindful Developer Account is different than a Kindful Partner account.

Create an OAuth Application

Sign in to your developer account and then click "Create Application".

Here you name your application, assign its redirect URI(s), and there are a few options:
1) Only authorize users if they have a membership.
2) If authorization only for members is on, you can restrict it to a specific campaign that their membership is associated with.

URL's are required to be https

Crafting Authorize Link

The link to initiate authorization should contain your subdomain, client_id (application_id) and redirect_uri


Example response that will come as a parameter on your redirect_url


Retrieving the OAuth token

  --client_id: APPLICATION_ID
  --client_secret: APPLICATION_SECRET
  --grant_type: 'authorization_code'
  --redirect_uri: REDIRECT_URI

Example Response

  "access_token": "ACCESS_TOKEN",
  "token_type": "bearer",
  "expires_in": "2508735",
  "scope": "basic",
  "created_at": "1474577889"


When the user signs into Kindful, an access_token will be sent back.

Retrieve User Details

Authentication Headers

Content-Type: application/json
Authorization: Bearer <access_token>

A user's details can be retrieved by hitting





User's name


User's email


Kindful identifier for user

Additional fields may be setup for your organization to identify membership levels. For example, you could use custom field values to indicate membership levels.