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

# Connect your data

> Connect the tools that hold your business data and the platforms you activate segments to

Integrations is where you connect Minerva to your other tools. A connection can be a source, a destination or both.

* A **source** brings your data into Minerva: customers, orders, CRM records, website activity, messaging and ad performance.
* A **destination** lets you activate segments to that tool.

Connecting Google Ads as a destination doesn't also bring in your Google Ads performance data.

## Tools you can connect

**Add integration** on [**Integrations**](https://app.minerva.io/integrations) always shows the current list.

| Connects as | Tools |
| - | - |
| Source and destination | Customer.io, Google Ads, HubSpot, Iterable, Klaviyo, LinkedIn Ads, Lob, Meta Ads, Poplar, Salesforce, TikTok Ads |
| Source only | Amazon Ads, Amazon Selling Partner, AppLovin, AppsFlyer, AWS S3, BigQuery, Braze, Databricks, Google Analytics 4, Google Cloud SQL (MySQL), Google Sheets, HighLevel, Marketo, Microsoft Dynamics 365 CRM, Microsoft SQL Server, Mixpanel, Outreach, Pinterest Ads, PostgreSQL, SendGrid, Shopify, Snapchat Ads, Stripe, Twilio |
| Destination only | Microsoft Advertising, Reddit Ads, X Ads |

If the tool that holds your data isn't listed, you can connect a warehouse, a database or a file source that has its data. To send a segment to a tool that isn't listed, use a [CSV export](https://docs.minerva.io/platform/activation/csv-export.md).

## First-time setup

The first time you open **Integrations** in a new organization, a setup guide opens. It walks you through six kinds of data, one at a time. For each one, choose the tools that hold that data and select **Continue**, or select **Skip**. The tools you choose are added to **Setup**, ready to connect.

[Setup check](#setup-check) tracks the same six kinds of data afterward.

## Connect an integration

**1. Open Integrations**

Select [**Integrations**](https://app.minerva.io/integrations) in the sidebar.

**2. Add the integration to Setup**

If the tool isn't in **Setup** yet, select **Add integration**, choose the tool and select **Add to setup**.

**3. Connect it**

Select **Connect** on the integration. Complete the tool's sign-in, consent or API key step, and choose the right account when you're asked.

**4. Check the result**

Back in Minerva, check the connection's status. Closing the other tool's window doesn't mean the connection worked.

**5. Give a source time to finish**

For a source, give Minerva time to finish the first sync and get your data ready to use. How long it takes depends on the tool and how much data it holds. Review any **Incomplete** or **Reconnect required** notice.

For a destination, the next step is to activate a segment. Connecting a destination doesn't send anything.

Minerva Agent can also point you to a source you still need to connect. If a question needs data you haven't connected, the Agent shows the source with a **Connect** button, which opens its setup in **Integrations**. Once the data is ready, go back to the Agent and ask again.

## Check where your data stands

[**Integrations**](https://app.minerva.io/integrations) shows where your data stands in two places.

### Connected integrations

Every connection is listed with a status.

| Status | What it means |
| - | - |
| **Setting up** | The connection is being set up. The status updates automatically. |
| **Incomplete** | Setup isn't finished. Open the connection to see what's missing. |
| **Active** | The connection is working. For a destination, this doesn't mean any data has been imported. |
| **Reconnect required** | Access has lapsed and needs to be authorized again. |
| **Needs attention** | Something needs fixing before the connection works properly. |
| **Paused** | Syncing is paused. |
| **Unknown** | The status couldn't be loaded. It doesn't mean there is no data. |

### Setup check

**Setup check** groups your sources into six kinds of data:

* **Customer records**
* **Orders & revenue**
* **Sales pipeline**
* **Web & app activity**
* **Email & messaging**
* **Ad spend**

Each group shows one status.

| Status | What it means |
| - | - |
| **No source** | Nothing is connected for this kind of data. |
| **Setup in progress** | A source has been added and still needs to be connected. |
| **Preparing data** | A source is connected. Minerva is unifying its data so it's ready to use across the platform. |
| **Connected** | A source is ready to use in Minerva. |

A group shows **Connected** as soon as one of its sources is ready, so other sources in it can still be in progress. Some features need more than one kind of data. See [What each feature needs](#what-each-feature-needs). A destination doesn't count toward **Setup check**.

## What each feature needs

| Feature | What has to be ready |
| - | - |
| Analysis with Minerva Agent | The sources that hold the numbers you're asking about, connected and ready for analysis. |
| Owned audience search | Your customer and lead data, connected and ready to search. |
| Personas | Your customer and order data, connected and ready to use. |
| Propensity scores | Your customer and order data, and scoring turned on for your organization. Connecting a CRM alone isn't enough. |
| Products | Your product and order data. The page appears once Minerva has a product catalog for you. |

You can work with the Agent before any of this is ready. It analyzes your own data once the sources it needs are ready.

## Limits and billing

Connecting a tool and syncing data into Minerva don't use your record export allowance. Activations have their own billing and limits.

Removing or repairing a connection doesn't remove audiences you've already activated to that tool.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.