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

# Bulk Activating Cohorts

> How to request bulk activation of 30 or more cohorts

## Overview

If you need to activate 30 or more cohorts at once, Permutive's [Technical Services](mailto:technical-services@permutive.com) team can process the activations in bulk using a CSV file you provide. This guide explains how to prepare the CSV and submit the request.

<Info>
  **Prerequisites:**

  * 30 or more Custom or Lookalike cohorts that require activation.
  * The cohort ID (cohort code) for each cohort you want activated.
  * Destination-specific configuration values (e.g., network codes, advertiser IDs) ready for each activation.
  * Your workspace name and ID.

  **Limitations:**

  * Bulk activation is only supported for **Custom** and **Lookalike** cohorts. Contextual and Classification cohorts cannot be bulk activated.
  * A minimum of 30 cohorts is required per bulk activation request.
  * Each workspace requires a separate CSV file.
</Info>

## Supported Destinations

The following destinations are supported for bulk activation. Use the corresponding `activation_type` and `storage_key` column value in your CSV.

| Destination                        | `activation_type` | `storage_key`                          |
| :--------------------------------- | :---------------- | :------------------------------------- |
| Google Ad Manager                  | `gam`             | Leave blank                            |
| DV360                              | `dv360`           | Leave blank                            |
| Xandr / AppNexus                   | `appnexus`        | Leave blank                            |
| Nativo                             | `nativo`          | Leave blank                            |
| Facebook                           | `facebook`        | Leave blank                            |
| Magnite / Rubicon                  | `rubicon`         | Leave blank                            |
| PubMatic                           | `pubmatic`        | Leave blank                            |
| Trade Desk 1P                      | `trade_desk`      | Leave blank                            |
| Local Storage                      | `local_storage`   | LocalStorage key you are activating to |
| Index Exchange (via Local Storage) | `local_storage`   | `_pindexs`                             |
| Pinterest                          | `pinterest`       | Leave blank                            |

<Note>
  The [Index Exchange integration](https://docs.permutive.com/integrations/advertising/ssps/index-exchange) uses the Local Storage integration. In your CSV, set `activation_type` to `local_storage` and `storage_key` to `_pindexs`. Ensure the Local Storage integration is enabled in your Dashboard before submitting the request.
</Note>

## Steps

<Steps>
  <Step title="Gather your cohort codes">
    Collect the cohort ID (cohort code) for every cohort you want activated. You can find cohort codes in the *Custom Cohorts* list in the Permutive Dashboard — the code is displayed alongside each cohort's name.
  </Step>

  <Step title="Note your workspace name and workspace ID">
    You will need to provide these alongside your CSV when contacting [Technical Services](mailto:technical-services@permutive.com). Both are available in your Permutive Dashboard workspace settings.
  </Step>

  <Step title="Create the CSV file">
    Create a CSV file with the following header row, then add one row per cohort activation:

    ```csv theme={"dark"}
    "cohort_code","activation_type","ttd_secret","ttd_advertiserid","dfp_name","dfp_network_code","storage_key","dv360_seat","pinterest_tag_id","pinterest_tag_name"
    ```

    See the [CSV Columns reference](#csv-columns) below for details on what to include in each field.
  </Step>

  <Step title="Submit the request to Technical Services">
    Send the CSV file to [Technical Services](mailto:technical-services@permutive.com) along with your workspace name and workspace ID.
  </Step>
</Steps>

<Tip>
  Bulk activations are typically completed within two weeks of submission.
</Tip>

## CSV Columns

| Column               | Required | Description                                                                                                                       |
| :------------------- | :------- | :-------------------------------------------------------------------------------------------------------------------------------- |
| `cohort_code`        | Yes      | The cohort ID of the cohort to activate.                                                                                          |
| `activation_type`    | Yes      | The destination identifier. See [Supported Destinations](#supported-destinations) for the correct value.                          |
| `ttd_secret`         | No       | Required for Trade Desk activations. Leave blank otherwise.                                                                       |
| `ttd_advertiserid`   | No       | Required for Trade Desk activations. Leave blank otherwise.                                                                       |
| `dfp_name`           | No       | Required for Google Ad Manager activations. Leave blank otherwise.                                                                |
| `dfp_network_code`   | No       | Required for Google Ad Manager activations. Leave blank otherwise.                                                                |
| `storage_key`        | No       | Required for Local Storage and Index Exchange activations. For Index Exchange, use `_pindexs`. Leave blank otherwise.             |
| `dv360_seat`         | No       | Required for DV360 activations. Leave blank otherwise.                                                                            |
| `pinterest_tag_id`   | No       | Required for Pinterest activations. The Pinterest pixel Tag ID associated with your Pinterest destination. Leave blank otherwise. |
| `pinterest_tag_name` | No       | Required for Pinterest activations. The human-readable name of your Pinterest destination. Leave blank otherwise.                 |

<Warning>
  Leave optional columns present in the header but with an empty value for rows that do not use them. Do not remove columns from the CSV header.
</Warning>

## Example

The following example shows a single cohort (ID `123456`) activated to Pinterest, Facebook, and Index Exchange (via Local Storage):

```csv theme={"dark"}
"cohort_code","activation_type","ttd_secret","ttd_advertiserid","dfp_name","dfp_network_code","storage_key","dv360_seat","pinterest_tag_id","pinterest_tag_name"
123456,"pinterest",,,,,,,"1234567890","Example Publisher"
123456,"facebook",,,,,,,,
123456,"local_storage",,,,,"_pindexs",,,
```

Each row represents one activation. A single cohort can have multiple rows if it needs to be activated to more than one destination.

## Next Steps

<CardGroup cols={2}>
  <Card title="Creating Custom Cohorts" icon="plus" href="/guides/signals/cohorts/custom/creating-custom-cohorts">
    Build a new audience segment using the Cohort Builder
  </Card>

  <Card title="Creating Lookalike Cohorts" icon="circle-nodes" href="/guides/signals/cohorts/modeled-lookalike/creating-lookalike-cohorts">
    Create lookalike cohorts from a trained model
  </Card>

  <Card title="Back to Custom Cohorts" icon="arrow-left" href="/products/signals/cohorts/custom">
    Return to product overview
  </Card>
</CardGroup>