# Batch

Source: https://amplitude.com/docs/data/destination-catalog/batch

---

On this page

- [Considerations](#considerations)
- [Set up the integration](#set-up-the-integration)
- [Batch setup](#batch-setup)
- [Amplitude setup](#amplitude-setup)
- [Send a cohort](#send-a-cohort)
- [Locate your cohort in Batch](#locate-your-cohort-in-batch)

# Batch

[Batch](https://batch.com/) is a customer engagement platform that lets publishers personalize push notifications and emails across mobile platforms and web browsers. Batch offers a SaaS solution that integrates with apps and websites through an SDK. This integration syncs cohorts from Amplitude to Batch.

## Considerations

- This integration is available for customers on paid Amplitude plans.
- Enable this integration in each Amplitude project where you want to use it.
- This integration requires a paid Batch plan.
- The integration requires both custom audiences and third-party connections in Batch.
- Batch expects an identifier that matches the Batch Custom User ID or the Installation ID field. The `user_id` or user property you select in Amplitude must contain the same identifier as the one tracked in Batch in one of these fields.

## Set up the integration

Batch supports two types of cohort destinations:

- Use the **Batch (Profile)** destination to sync cohorts with your Batch Omnichannel project.
- Use the **Batch** destination to sync cohorts with a specific mobile app or website.

### Batch setup

1. In Batch, navigate to *Settings > General*.
2. Copy the API key (Live API Key for mobile or SDK API Key for web) of the application where you want to use Amplitude cohorts, or the Project key of the omnichannel project where you want to use Amplitude cohorts.
3. Copy your account's REST API key.

### Amplitude setup

1. In Amplitude Data, click **Catalog** and select the **Destinations** tab.
2. In the Cohort section, click **Batch** or **Batch (Profile)**.
3. Click **Add another destination**.
4. Enter a **Name** and paste in the **API key** you copied from Batch.
5. If you don't use the **Batch (Profile)** destination, select the type of identifier composing your segment on Batch (Custom User ID or Installation ID).
6. Map the Amplitude `user_id` field to the Batch `user_id` field.
7. Save when finished.

## Send a cohort

To sync your first cohort:

1. In Amplitude, open the cohort you want to sync, then click **Sync**.
2. Select **Batch**, then click **Next**.
3. Choose the account you want to sync to.
4. Choose the sync cadence.
5. When finished, save your work.

## Locate your cohort in Batch

After Amplitude syncs the cohort to Batch, it appears in the *Audiences* tab of the dashboard. Select it in the targeting section of the campaign editor to use it in a Push, In-App, Email, or SMS campaign. This helps you include or exclude a segment of users from your campaign.

Was this helpful?

<!--$-->

<!--/$-->
