Skip to main content

Church Community Builder (CCB)

CCB is the most common church database integration. When connected, Ministry Toolkit imports people, families, forms, registrations, and payments from CCB on a regular sync, and writes records back where applicable.

What you'll need​

  • Your CCB subdomain: the part before .ccbchurch.com in the URL you use to log in. For example, if your CCB is at https://yourchurch.ccbchurch.com, the subdomain is yourchurch.
  • A CCB API username and password. This is a special user account in CCB with API access enabled. Your CCB admin can create one under System Settings → API.
  • Permissions on that API user for the resources Ministry Toolkit will read: People, Forms, Form Responses, Transactions, Groups (if using Attendance), and Saved Searches (if using Follow Up).

Connecting​

  1. In Ministry Toolkit, go to Workspace Settings → Integrations.
  2. Find Church Community Builder and click Connect.
  3. Enter your subdomain, API username, and API password.
  4. Save. Ministry Toolkit verifies the credentials and runs an initial sync.

If the credentials are rejected, check that the API user is enabled in CCB and that its permissions include all the resources above.

How sync works​

  • Scheduled sync runs in the background on a regular cadence so data stays fresh without manual intervention.
  • Manual sync can be triggered from the Sync button in any app's toolbar. Use this when you've just made changes in CCB and want them reflected immediately.
  • Per-app sync log is visible under Workspace Settings → Sync History. Each entry shows what app ran, when, and any details or errors.

Permissions checklist​

If a sync runs but specific data is missing, the API user often needs more permissions. Common gaps:

  • Forms not appearing: the API user lacks Form access.
  • Payments not importing: the API user lacks Transaction access.
  • Saved Searches missing in Follow Up: the API user lacks Saved Search access.
  • Groups not appearing in Attendance: the API user lacks Groups access.

Update the user's role in CCB and the next sync will pick up the missing data.

Disconnecting​

To disconnect CCB, go to Workspace Settings → Integrations → Church Community Builder and click Disconnect. Existing imported data stays in Ministry Toolkit; only future syncs stop.

Last updated on