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

# Activation overview

> Activate a segment to an ad platform, a CRM or a direct mail provider, or export it as a CSV file

An activation sends the people in a segment to a destination, such as an ad platform, a CRM or a direct mail provider. Minerva sends the segment, and you run the campaign or mailing in the tools you already use. You can connect a destination the first time you use it, and it'll be available for future activations.

## Choose a destination

When you activate, destinations are grouped like this:

| Group | Destinations | Uses allowance | Guide |
| - | - | - | - |
| **Paid ads** | Meta Ads, Google Ads, TikTok Ads, LinkedIn Ads, X Ads, Reddit Ads or Microsoft Advertising | No | [Ad platforms](https://docs.minerva.io/platform/activation/ad-platforms.md) |
| **Marketing** | Iterable, Klaviyo or Customer.io | Yes | [CRM and lifecycle tools](https://docs.minerva.io/platform/activation/crm-and-lifecycle.md) |
| **Sales** | HubSpot or Salesforce | Yes | [CRM and lifecycle tools](https://docs.minerva.io/platform/activation/crm-and-lifecycle.md) |
| **Direct mail** | Lob or Poplar | No | [Direct mail](https://docs.minerva.io/platform/activation/direct-mail.md) |
| **CSV export** | A file you download and import yourself | Depends on the format | [CSV export](https://docs.minerva.io/platform/activation/csv-export.md) |

## Before you start

* **Build a segment.** Save one from Person Search, Bulk Enrich or another source. You can activate it once it has finished building.
* **Connect the destination as you go.** Pick a destination when you activate. If you haven't connected an account for it, select **Add account** on the **Configure** step. Minerva takes you to the provider to sign in, then returns you to the activation. Google Ads is the exception: connect it under **Integrations** first. A CSV export needs no connection. A tool you connected as a data source isn't automatically ready to receive segments as a destination.
* **Check your limits.** An activation has to fit your operational limits, which you can see on [Billing & Usage](https://app.minerva.io/settings/billing). A record export also needs record export allowance, or room under your **Monthly limit** if your plan includes [overage](https://docs.minerva.io/platform/key-terms.md#overage).

## Activate a segment

**1. Open the segment**

Open the segment and select **Activate**.

**2. Pick a destination**

Under **Pick a destination**, choose where the segment should go.

**3. Configure the activation**

On **Configure**, choose the account and the list, audience or campaign to send to, and any fields the destination lets you select. Select **Continue**.

**4. Set size and filters**

On **Size and filters**, set the maximum number of records. Turn on **Run email validation** or **Run address verification (NCOA)** if you want them. Select **Continue**.

**5. Review suppression and exclusions**

On **Suppression & exclusions**, keep **Apply suppression list** selected and choose any segments to exclude. If a list of your brands appears, clear any brand this activation isn't for. Select **Review**. For HubSpot, Salesforce and some CSV formats, the step is named **Exclusions**. See [Suppression, exclusions and filters](#suppression-exclusions-and-filters).

**6. Review and activate**

Check the details on **Review activation**, then select **Activate**, or **Export** for a CSV. The review shows **Records: Up to** a number. That number is a maximum, not a guarantee. It also shows a **Suppression list** line with the channels it covers. If a brand list was shown, the review names the brands you selected.

**7. Finish in the destination**

Track the activation on the segment's **Activations** tab. Then finish any review, campaign setup or sending in the destination.

## Suppression, exclusions and filters

Every activation lets you control who's included, so you reach only the people you mean to.

| Control | What it does | Use it to |
| - | - | - |
| **Exclusion lists** | Removes everyone in the segments you choose, up to 50. | Leave out existing customers, people you've already reached, or another campaign's segment. |
| **Apply suppression list** | Removes people who have opted out of the channel you're sending to: ads or data sharing, email, or direct mail. | Contact only people you're allowed to reach. It's selected by default. Keep it selected. |
| **Run email validation** | Keeps only valid email addresses. | Protect your sender reputation in email tools. |
| **Run address verification (NCOA)** | Checks postal addresses against National Change of Address (NCOA), the US Postal Service's record of address changes, and sends the corrected address when there is one. | Avoid wasted postage on direct mail. |

You'll find suppression and exclusion lists on the **Suppression & exclusions** step, and validation on **Size and filters**.

Minerva builds the suppression list from the contact permissions available for your organization, including recorded opt-outs and other restrictions that apply to the destination you select. For email, Minerva removes the address that opted out. A person with another email address that hasn't opted out can still be included.

If you clear **Apply suppression list**, people who opted out are included. People with an erasure or do-not-contact request on record are left out of every activation, including HubSpot, Salesforce and every CSV format, whether or not the option is selected.

If your organization has more than one brand, people can opt out of one brand and not another. When contact permissions for the channel you're sending to are recorded by brand, a list of your brands appears under **Apply suppression list**, with every brand selected. Minerva applies the opt-outs for every selected brand. Clear a brand this activation isn't for, and its opt-outs are no longer applied. At least one brand has to stay selected. Opt-outs for a topic or for your whole organization always apply.

Suppression applies to ad platforms, Iterable, Klaviyo, Customer.io, Lob and Poplar, and to CSV files in **Meta Ads columns**, **Google Ads columns** or **Lob columns**. For HubSpot, Salesforce and the other CSV formats, the step is named **Exclusions** and has exclusion lists only. It's also named **Exclusions** when Minerva doesn't have access to contact permission data for your organization. In that case, Minerva has no opt-outs, erasure requests or do-not-contact requests to apply.

Suppression applies to each new activation. To remove someone from an audience you've already activated, remove them in that tool too.

## Track an activation

The **Activations** tab lists each activation with its **Destination**, **Details**, **Status**, **Date** and **Records**. **Download** appears when a completed activation produced a file.

| Status | What it means | What it doesn't tell you |
| - | - | - |
| **Preparing** | Minerva is getting the segment ready to send. | That records have reached the destination. |
| **Queued** | The activation is waiting to start. | That sending has started. |
| **Processing** | The activation is running. | That every record was accepted or matched. |
| **Connection required** | The connection needs your attention before the activation can continue. | That you need to start a new activation. |
| **Completed** | Minerva finished its part. A CSV is ready, or the segment has been handed to the destination. | That ads are running or mail was sent, or how many people the destination matched. |
| **Failed** | The activation didn't finish successfully. | That nothing reached the destination. Some records may already have arrived. |

> [!NOTE]
>
> Refreshing a status doesn't resend anything. If an activation fails, check the destination before you start a new one.

## Why fewer people may be sent

The number sent can be smaller than the segment or the maximum you set. People drop out when:

* They lack an identifier the destination needs, such as an email or a postal address.
* Several contacts belong to the same person.
* You excluded them, they are on your suppression list, or Minerva has an erasure or do-not-contact request on record for them.
* Validation removes an email or an address.
* The destination rejects them or can't match them.

Minerva doesn't replace the people it removes, so the final count can be lower than the size you set.

## Each activation is a snapshot

An activation sends the people selected when it runs. Editing the segment later doesn't change an activation you've already run, and adding someone to your suppression list doesn't remove them from a destination they were already sent to. Create a new activation to send the updated segment.

## Limits and billing

* Activations to **Paid ads** and **Direct mail** destinations, and CSV files in an ad platform, direct mail or hashed email format, are [campaign activations](https://docs.minerva.io/platform/key-terms.md#campaign-activation) and don't use your record export allowance. Activations to **Marketing** and **Sales** destinations, and general CSV files (the **All columns**, **HubSpot columns** and **Salesforce columns** formats), are record exports and use your allowance.
* Operational limits apply to both kinds. There is a limit per activation and a limit per calendar month, counted in UTC. See your limits on [Billing & Usage](https://app.minerva.io/settings/billing), and read [how limits and allowance work](https://docs.minerva.io/platform/workspace/billing-and-usage.md).
* Address verification (NCOA) needs at least 100 unique postal addresses.
* A destination can set a lower maximum or a minimum of its own.


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