​

Overview

To authenticate with Pushpay ChMS (v2), you will need:

1. Church subdomain — the hostname prefix for your ChMS site (https://{subdomain}.ccbchurch.com).
2. A church administrator who can authorize the vendor app (Master Administrator, or permission to edit system-wide settings).

This guide walks through finding your church subdomain and completing System Auth.

​

Prerequisites:

• Your vendor OAuth application must already be registered with Pushpay / Church Community Builder.
• The church must not have revoked vendor access for your application.

​

Instructions:

​

Step 1: Finding your Church subdomain

1. Log in to Pushpay ChMS for the church you want to connect.
2. Look at the site URL in your browser. It is of the form https://{your-subdomain}.ccbchurch.com.
3. The value before .ccbchurch.com is your Church subdomain (for example, acme from https://acme.ccbchurch.com).

​

Step 2: Enter credentials in the Connect UI

Once you have your Church subdomain:

1. Open the form where you need to authenticate with Pushpay ChMS (v2).
2. Enter your Church subdomain in its respective field.
3. Submit the form, and you should be successfully authenticated.

You are now connected to Pushpay ChMS (v2).