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


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