---
title: Sending Data to Custify
slug: sending-data-to-custify
description: Plan your data, then connect it through integrations, the API, data warehouses, Segment, or the JS snippet, or import CSVs and MRR history manually.
createdAt: 2024-08-01T10:54:56.098Z
---

*A customer success platform is only as powerful as the data that goes into it. Here is how to plan your data, connect your sources, and keep everything accurate over time.*

# Overview

Custify can receive data automatically (API, native integrations, data warehouses, JavaScript snippet, Segment) or manually (CSV imports and manual edits). Most teams combine both: core data flows in automatically, and a few attributes are maintained by the CS team.

As part of the Concierge Onboarding, our CS team will help you decide what data to use and how to send it. This article gives you the full picture so you can plan ahead.

# Step 1: Plan your data

Before connecting anything, agree internally on four points:

- **Customer portfolio:** which Companies and People (users) should be in Custify?
- **Hierarchy:** do you use parent and child relationships? Are People assigned to multiple Companies? Do you have other entities you want to track as child entities (projects, locations, departments)?
- **Attributes:** which company and people attributes matter for your CS processes (plan, MRR, renewal date, owner, and so on)?
- **Events:** which actions do you want to track, at People or Company level? Do you need them in real time, or aggregated as a daily event? Which metadata matters for each event?

:::hint{type="info"}
**Custify Tip:&#x20;**&#x41;ttributes do not bubble up from People to Companies, or from children to parents, and they are not changed by events. If you track a “login” event and a “number of logins” attribute, update the attribute separately. Events do bubble up from People to Companies and from children to parents.
:::

# Step 2: Follow the Onboarding Data Wizard

The [Onboarding Data Wizard ](https://kb.custify.com/onboarding-data-wizard)guides a new account through data setup in the right order: **Team > Goals > Core entities > Conversations > Financial > Usage**. Each step explains why it matters, shows what Custify already detects in your account, and links to the setup page you need.

![](https://api.archbee.com/api/optimize/16HhozMLfMR_uwZBLzFrU/TjV2juOK8L7GGLazgGLnr_image.png)

1. Open the wizard from the prompt at the top of the app, or from *Settings > Data management > Onboarding Data*.
2. Work through each step. When you leave to finish a setup page (Users, Integrations, API access, JS snippet, Data Importer, Data Warehouses, My Account), a *Return to wizard* prompt brings you back to the same step.
3. Skip a step with a reason if it does not apply, and unskip it later. Use *Refresh* to check progress against live data.

Any user with data management permissions can run the wizard. Restarting it does not disconnect your existing integrations.

# Step 3: Connect your sources automatically

Sending data automatically is always the preferred option: it keeps data fresh and removes the risk of human error.

## Native integrations

Custify connects natively with CRMs, billing and subscription tools, support desks, product analytics, calendars and email, note takers and more. Go to *Settings > Integrations*, browse by category or use the search box, and connect the tools you use. Recent additions include Amplitude, Gong, ServiceNow, AskNicely, Crisp, Asana, Linear, Grain, Granola, Groove, Pylon, Maxio and Younium.

CRM integrations can run in two modes:

- **Full mode:** the integration creates and continuously updates Companies, People and attributes in Custify. Best when you want your portfolio in Custify quickly without development work.
- **Enhance mode:** your portfolio arrives from another source (for example the API), and the integration enriches existing records. You choose a matching ID at company and contact level, then select the fields to import and export.

:::hint{type="info"}
**Custify Tip:&#x20;**&#x43;lick the *Synced X minutes ago* label on any integration card to open the **Integration Logs&#x20;**(where available). Logs are kept for 30 days and show failures, retries and the sync status of each record.
:::

## Custify API

With a custom API integration, you can create and update People, Companies, events, notes, tasks, tags, custom data, meetings, financial data, objectives and more, and read back surveys, tickets, health scores, segments, lifecycles and calculated metrics.

- Create API keys in *Settings > Developer > API Access*. Keys can also be **read only**.
- Use the API URL shown in *Settings > Developer*. If your account runs in a regional data center, the URL differs from the default one, and using the right one speeds up event processing.

## Data warehouses

If your product usage and account data already live in a data warehouse, you can import it into Custify straight from your tables, without building an API integration. Custify reads the tables you choose on a regular schedule and keeps your records up to date.

**Supported sources:** Snowflake, BigQuery, AWS Redshift, AWS Athena, Azure Synapse, Postgres, MySQL, MongoDB and Posthog. Notion and Airtable are also supported as direct sources. Setup guides for each source are listed in [Data Warehouse.](https://kb.custify.com/data-warehouse)

:::hint{type="warning"}
**Observation:&#x20;**&#x54;he Data Warehouse integration is a subscription add on and is disabled by default. Activate it from *Settings > Subscription*, or contact your CSM.
:::

To set up a sync:

1. Go to *Settings > Data Warehouses*, click *New Sync*, then *New Source*, and select your warehouse.
2. Fill in the connection details. We recommend a dedicated user (or service account) for Custify that can only access the data you want to sync. If your database only accepts known IP addresses, ask your CSM for the Custify IPs to allow.
3. Choose the Custify object to create from this data: Companies, People, Events, Custom Data or Notes.
4. Select the namespace and the table (or view) that holds the data.
5. Map the columns in your table to the fields Custify expects, such as company\_id, user\_id, event name and timestamp, plus any attributes or metadata you want to bring in.
6. Save and run the sync. Each run is listed in the sync status table, with the number of records processed.

Like CRM integrations, a warehouse sync can **create** records or run in **Enhance mode**. In Enhance mode, the sync only adds data to companies that already exist in Custify and never creates new ones. This is useful when your portfolio comes from another source and the warehouse only enriches it.

Once a sync is running, you can edit it, delete it, trigger a full reimport, or **pause** it and resume it later, for example while you change the table structure on the warehouse side. Syncs run at a set interval counted from the end of the previous run, so they do not start at a fixed day and time.

:::hint{type="info"}
**Custify Tip:&#x20;**&#x43;reate a separate sync for each object type (one for companies, one for people, one for events) to keep mapping simple.

If a person belongs to several companies, use one row per person and company pair (user\_id, company\_id).

Use a timestamp column, not a plain date, for the last updated field, so Custify can detect changes correctly.

Unpack JSON fields into separate columns before syncing; each column can then become an attribute or event metadata.

Events can carry a deduplication ID, which prevents duplicates when you run a full reimport.
:::

:::hint{type="warning"}
**Observation:&#x20;**&#x52;enaming columns in your warehouse, or deleting the matching attributes in Custify, breaks the field mapping. Pause the sync, update the mapping, then resume it.
:::

## Segment

Add your Custify API key to your [Segment](https://www.twilio.com/docs/segment/connections/destinations/catalog/custify) settings to push your customer portfolio and tracked events, and to send Segment traits as attributes.

## JavaScript snippet

Insert the [JavaScript snippet](https://docs.custify.com/#section/JAVASCRIPT/Send-data-using-the-JavaScript-snippet) in your app pages to create and update people and companies and to track events such as button clicks, menu clicks, and time spent in your product.

## Conversations and meetings

- **Gmail and Outlook:** emails and meetings sync to the matching people and companies. Add secondary email addresses (comma-separated) in a people attribute so conversations from personal or alternative addresses land on the same contact.
- **Note takers:** meeting summaries from Fathom, Fireflies, tl;dv and Gong can be imported as Notes, which makes them searchable and ready for follow-up tasks.
- **Partners and shared contacts:** in *Settings > General > Data Handling*, tag people whose conversations should not bubble up to every company they belong to.

# Step 4: Add data manually when needed

Some data is easier to maintain by hand, or needs a one-time import.

- **Add People and Companies one by one** with the *Add company* and *Add people* buttons. This option is not enabled by default; contact your CSM if you need it.
- **Upload in bulk** with the [CSV Data Importer](https://kb.custify.com/how-does-the-csv-data-importer-work) to create People and Companies, add or update attributes, and upload events.

![](https://api.archbee.com/api/optimize/16HhozMLfMR_uwZBLzFrU/ssK-ViPwkH6tb1XCqFmqK_image.png)

- **Create manual attributes** in *Settings > Event & Attribute Editor*, then fill them from the Customer 360° Profile, from the Customer List View, through a Customer Portal form, or automatically with a Playbook.

## Historical MRR imports

The CSV Data Importer has a dedicated **Historical MRR** import type, so your revenue dashboards show months of history from the first day instead of starting from a flat line.

1. Go to *Settings > Data Importer > New Import* and select the **Historical MRR** card.
2. Download the template. It has three columns: *company\_id*, *mrr* and *date*. Add one row each time a company’s MRR changed; Custify fills in the days in between and carries the last value forward to today.
3. Map the columns and choose how to treat MRR history that already exists in Custify (see the table below).



| **Option**                                                | **What happens**                                                                                |
| --------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
| Clear history from first imported record onward (default) | For each company in the file, deletes existing records from the earliest CSV date through today |
| Clear all MRR history for imported companies              | Deletes all stored history for the companies in the file                                        |
| <br />Clear all MRR history for all companies             | Deletes MRR history for the whole account (requires a confirmation checkbox)                    |
| Keep existing MRR history                                 | Only adds or updates the imported rows                                                          |

:::hint{type="warning"}
**Observation:&#x20;**&#x41;n MRR attribute must be configured under *Settings > General* before you run this import.&#x20;

![](https://api.archbee.com/api/optimize/16HhozMLfMR_uwZBLzFrU/HmPQYde411fKUpWevGlzI_image.png)

Rows with an unknown company\_id, or an invalid MRR or date, are rejected and listed in the import summary. The current MRR value on each company does not change; only the timeline is populated.
:::

# Summary: which method supports what

|                                       | API | Segment | JS snippet | CRM (Full mode) | Custify UI | Data importer |
| ------------------------------------- | --- | ------- | ---------- | --------------- | ---------- | ------------- |
| Create Companies and People           | ✅   | ✅       | ✅          | ✅               | ✅          | ✅             |
| Assign People to Companies            | ✅   | ✅       | ✅          | ✅               | ✅          | ✅             |
| Create parent and child relationships | ✅   | ✅       | ❌          | ❌               | ✅          | ✅             |
| Create and update attributes          | ✅   | ✅       | ✅          | ✅               | ✅          | ✅             |
| Send events                           | ✅   | ✅       | ✅          | ❌               | ❌          | ✅             |

# Keeping your data clean

- **Merge duplicate companies** from the Company 360 page of the record you want to keep. You choose which data moves from the duplicate (notes, tasks, people, child entities, communication, meetings, tickets, files, custom and financial data). Health scores, calculated metrics, attribute history and activity logs are not moved.
- **Delete attributes** you no longer need directly from *Settings*. A safety check runs before the deletion completes.
- **Export the Event & Attribute Editor** with filters applied to review your data model with your tech team.
- **Check tag usage** in *Settings > Tags* to see how many records use each tag before cleaning up.

## Test changes safely in a Sandbox

Before a large import or a configuration change, create a **Sandbox** in *Settings > Data Management > Sandbox*. It is an isolated, empty account valid for 30 days, with the same API limits as production, up to 100 companies and 1,500 people. No customer data is copied into it.

:::hint{type="warning"}
**Observation:&#x20;**&#x4D;ost third party tools allow only one active connection. To test an integration such as Pipedrive in the Sandbox, you first need to disconnect it from your production account. Use a different browser for the Sandbox than for your production account.
:::

# Sending data out of Custify

Data can also flow from Custify to your other systems:

- **Two-way CRM sync** pushes health scores, calculated metrics, and other values back to tools such as HubSpot and Salesforce.
- **Outgoing webhooks** (*Settings > Developer > Outgoing Webhooks*) notify your systems instantly when notes, tasks, survey responses, or portal links are created or updated. Deliveries are signed, retried automatically, and logged.
- **Custify MCP server** connects AI tools such as Claude, ChatGPT, Cursor, or VS Code to your live Custify data. Use the hosted server or the open-source local version; setup snippets are in *Settings > Developer > MCP Server*.

# Related articles

- [Custify Overview](https://kb.custify.com/custify-overview)
- [How does the CSV Data Importer work?](https://kb.custify.com/how-does-the-csv-data-importer-work)
- [Integrations](https://kb.custify.com/integrations)
- [Technical documentation](https://docs.custify.com)

