> ## Documentation Index
> Fetch the complete documentation index at: https://nango.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Pushpay ChMS (v1) - How do I link my account?

# Overview

To authenticate with Pushpay ChMS, you will need:

1. **Church subdomain** — the hostname prefix for your ChMS site (`https://{subdomain}.ccbchurch.com`).
2. **API username** — created in **API Admin** inside Pushpay ChMS (not the API User Community login).
3. **API password** — the password for the API user created in **API Admin**.

This guide will walk you through finding your **Church subdomain** and creating an **API user** within Pushpay ChMS.

### Prerequisites:

* You must have a Pushpay ChMS account with API access enabled for your organization.

### Instructions:

#### Step 1: Finding your Church subdomain

1. Log in to Pushpay ChMS as an administrator.
2. Open **API Admin** (location may vary by version; your implementer guide references this section).
3. Note the HTTPS base URL for API calls. It is of the form `https://{your-subdomain}.ccbchurch.com/api.php`.
4. The value **before** `.ccbchurch.com` is your **Church subdomain** (for example, `acme` from `https://acme.ccbchurch.com`).

#### Step 2: Create an API user

1. In Pushpay ChMS, go to **API Admin**.
2. Create a dedicated API login for this integration (recommended so access can be revoked independently).
3. Assign only the **services** this integration needs; each login's permissions are granular per service.
4. Copy the **username** and **password** for use in Nango.

#### Step 3: Enter credentials in the Connect UI

Once you have your **Church subdomain**, **API Username**, and **API Password**:

1. Open the form where you need to authenticate with Pushpay ChMS.
2. Enter your **Church subdomain**, **API Username**, and **API Password** in their respective fields.
3. Submit the form, and you should be successfully authenticated.

<img src="https://mintcdn.com/nango/ACiSiLYfCBSQhsSE/api-integrations/pushpay-chms-v1/form.png?fit=max&auto=format&n=ACiSiLYfCBSQhsSE&q=85&s=a26f6e54271fdf1e2dbc4413f9758332" style={{maxWidth: "450px" }} width="1002" height="1268" data-path="api-integrations/pushpay-chms-v1/form.png" />

You are now connected to Pushpay ChMS (v1).