---
description: Configuration details for the Churnzero integration.
---

# Churnzero

## Overview

This integration allows you to sync data between your sources and Churnzero.

## Initial Setup <a href="#initial-setup" id="initial-setup"></a>

To find the setup key, navigate to Admin > Application Keys > New App Key and create a new key with the name of your choice.&#x20;

![](https://1454996985-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MHsth_4gateO06TTdt4%2F-MYfXm51Vahv46FPqEcc%2F-MYf_qRHVTmueVohom3W%2FPasted_Image_4_20_21__3_24_AM.png?alt=media\&token=b2322f91-236d-4e9f-97b3-5bed987e298c)

Use the application key as your "App Key" in Hightouch.

## Syncing Churnzero Objects

### Object Types

Hightouch supports syncing to the following Churnzero objects:

* Contacts
* Accounts

Contacts must be associated with an account, and therefore an account external ID must be present in your data.

### Sync Modes

This integration only supports the Upsert mode.

In this mode, new contacts and accounts will be inserted into Churnzero and all attributes will be kept up-to-date within Churnzero.

### Record Matching

Records can be matched from your source to your Churnzero workspace by your Churnzero Contact / Account ID. Note: this can be found in the top left of your contact or account page (not the ID in the url).

![](https://1454996985-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MHsth_4gateO06TTdt4%2F-MYfXm51Vahv46FPqEcc%2F-MYfchgA7zl4EI4fMqqK%2Fimage.png?alt=media\&token=79557873-1337-4999-b466-68de19635dd1)

There is an additional field when syncing contacts, which is the column that contains the external account ID in your query results. Please make sure that the account exists in Churnzero already.

{% hint style="warning" %}
We don't receive detailed errors from Churnzero, such as checking whether an account ID referenced or a custom field exists or not. Therefore, we are not able to provide detailed logging.
{% endhint %}

### Field Mapping

You can sync columns from your source to Churnzero's default and custom fields.&#x20;

![](https://1454996985-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MHsth_4gateO06TTdt4%2F-MYfdfbWyRE3NCT-L1BC%2F-MYfe6023YSgxr2OYdej%2Fimage.png?alt=media\&token=5ffeed47-4730-4aa9-a9fb-30d7e29465c3)

You can find the custom fields created for your Churnzero workspace in Admin > Custom Fields then navigating to either the contact or account table. For custom fields, please use the CZ API Name as the name of the destination field in Hightouch.
