SupportLog InSign Up

How to register your own Pushpay ChMS v2 OAuth app

Register as a Pushpay ChMS partner and obtain OAuth credentials for Tenklo

This guide shows you how to obtain Client ID and Client secret credentials for the Pushpay ChMS (Church Community Builder) v2 OAuth API.

Pushpay ChMS v2 uses OAuth 2.0 System Auth. A Master Administrator (or a user who can edit system-wide settings) authorizes your vendor application for a church. You must become a value-added partner before you can create an OAuth application.

Apply as a value-added partner

  1. Open the partner application form.
  2. Submit the form and wait for Church Community Builder / Pushpay to provision an OAuth application for your integration.
  3. When your application is created, note the Client ID, Client secret, and the scopes approved for your app.

Configure the redirect URI

Ask Pushpay / Church Community Builder to register the Tenklo callback URL on your OAuth application:

https://api.tenklo.dev/oauth/callback

Choose scopes

Request only the scopes your product needs (for example read:individuals, read:groups, write:individuals). Scopes must be a subset of what was approved when your OAuth application was created. If you omit scopes during authorization, Pushpay defaults to the full set approved for your app.

Add credentials in Tenklo

In your Tenklo integration settings for Pushpay ChMS (v2), paste the Client ID, Client secret, and the scopes you need.