> ## 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.

# CRM and lifecycle tools

> Activate a segment to HubSpot, Salesforce, Iterable, Klaviyo or Customer.io, with the details you choose

Activating a segment to a CRM or lifecycle tool creates or updates records there. These activations are record exports, so they use your record export allowance. When you activate, Iterable, Klaviyo and Customer.io are listed under **Marketing**, and HubSpot and Salesforce under **Sales**.

## Before you start

* **Connect the destination.** Select **Add account** on the **Configure** step when you activate. A tool you connected as a data source isn't automatically ready to receive segments as a destination.
* **Check your allowance and limits.** You need record export allowance, or room under your **Monthly limit** if your plan includes [overage](https://docs.minerva.io/platform/key-terms.md#overage). The activation also has to fit your operational limits. You can check all of these on [Billing & Usage](https://app.minerva.io/settings/billing).
* **Make sure you have consent.** Sending people to a tool doesn't opt them in to marketing or create a subscription.

## Activate a segment to a CRM or lifecycle tool

**1. Open the segment and pick the destination**

Open the segment, select **Activate** and choose the tool under **Pick a destination**.

**2. Choose the account and how to match**

Select the account or project. Where the destination offers it, choose whether to match by email or to update only contacts you imported from that tool.

**3. Choose a list and fields**

Select the list or audience to add people to and, where the destination supports it, the fields to send.

**4. Set size, filters and exclusions**

Set the maximum size and any email validation, then choose any segments to exclude. For Iterable, Klaviyo and Customer.io, keep **Apply suppression list** selected. Read the record export notice. See [Suppression, exclusions and filters](https://docs.minerva.io/platform/activation/overview.md#suppression-exclusions-and-filters).

**5. Activate**

Select **Activate**.

**6. Check the records in the destination**

When the activation shows **Completed**, check the records or list in the destination before you start a campaign there.

## What each destination receives

| Destination | What Minerva does | What to know |
| - | - | - |
| **HubSpot** | Creates or updates contacts, matched by email. | You can choose to update only imported contacts and to write to separate Minerva properties. See HubSpot options below. |
| **Salesforce** | Creates or updates Contacts, matched by email. | Doesn't change Account relationships. A last name is needed to create a Contact. |
| **Iterable** | Creates or updates profiles and adds them to a static list. | Can create the list if it doesn't exist. If you deleted a profile in Iterable, an activation can create it again. |
| **Klaviyo** | Adds profiles to a list you select. | Doesn't subscribe anyone to marketing. |
| **Customer.io** | Creates or updates people and adds them to a manual segment. | Your account needs permission to create and update people. |

You can choose which fields to send for HubSpot, Salesforce and Iterable.

What happens to a field that has no value in Minerva depends on the destination and the field. In some tools, a blank can clear the existing value.

## HubSpot options

* **Matching.** By default, a contact is updated when its email matches and created when there is no match. You can choose to update only contacts imported from your HubSpot source. In that mode, people without a match are skipped and email addresses stay unchanged.
* **Write to separate Minerva properties.** When this is checked, details go to properties such as `minerva_first_name` and your standard HubSpot values stay unchanged. Otherwise, the details you select update the standard fields.
* **Scores.** Propensity scores always use the `minerva_propensity_score` property. A missing score leaves the existing HubSpot value unchanged.

## After you activate

* If an activation fails, check the destination before trying again. Some records may already have arrived.
* An activation is a snapshot. Editing the segment later doesn't update records you've already sent.
* The number of records in the destination can differ from the number of people counted against your allowance. One person can match several existing contacts.

## Limits and billing

* These activations are record exports. Each unique person counts once per contract term across every record export, including CSV files.
* Updating an existing contact still counts as exporting that person, if you haven't exported them earlier in the term.
* Sending a person you've already exported to a second tool in the same term doesn't use more allowance.
* Your operational limits apply separately, and repeat activations count toward them.


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