# Batch Audience

{% hint style="info" %}
This destination is currently under final review and will be available soon.
{% endhint %}

Batch lets CRM Teams design, test and automate their customer engagement strategies to keep users engaged and grow revenue. Using this destination you can share audiences with Batch by leveraging the [Custom Audience API 1.1](https://doc.batch.com/api/custom-audience/1.1/create/).

{% hint style="warning" %}
Audiences are synchronized using their names as identifier. Avoid renaming to maintain consistency.
{% endhint %}

## Key features

The Batch Audience destination provides the following key features:

* **Audience sharing**: our [Events reference](https://community.commandersact.com/platform-x/developers/tracking/events-reference) model drives audience sharing with Batch, meaning that you can synchronize your existing user segments, with your partner, in a seamless way.

## Destination setup

### Configuration

<table><thead><tr><th width="331">Settings</th><th>Description</th></tr></thead><tbody><tr><td><code>Batch API Key</code></td><td><em><strong><code>Required</code></strong></em><br>The <code>Batch API Key</code> value is either your Live or Dev Batch API key from the settings page of your app within the <a href="https://dashboard.batch.com">Batch dashboard</a> following <code>Settings</code> → <code>General</code>.</td></tr><tr><td><code>REST API Key</code></td><td><em><strong><code>Required</code></strong></em><br>The <code>REST API Key</code> value is available in the settings page of your app within the <a href="https://dashboard.batch.com">Batch dashboard</a> following <code>Settings</code> → <code>General</code>.</td></tr><tr><td><code>Custom User Id</code></td><td><em><strong><code>Required</code></strong></em><br>Set the property value you want to use as <code>Custom User Id</code>. More details are available by following this <a href="https://doc.batch.com/ios/custom-data/customid/">LINK</a>.</td></tr><tr><td><code>Custom Audience Properties</code><br><code>Mapping</code></td><td>Send custom properties related to audiences as Batch attributes. Set <code>Batch attribute name</code> with the attribute name to be set in Batch and <code>Your value</code> with the value you want to set. They can be used in <a href="https://doc.batch.com/guides/message-personalization/advanced/#custom-audience-data">message personalization</a>.</td></tr><tr><td><code>Custom Audience Properties</code><br><code>Tags</code></td><td>Send custom properties related to audiences as Batch tags. Set <code>Your value</code> with the tag value you want to use, one per line. See <a href="https://doc.batch.com/api/trigger-events-api/track-events/">Batch "Trigger Events API"</a> for more details.</td></tr></tbody></table>

## Field mappings

Created segments include the following properties:

<table><thead><tr><th width="193">Property Name</th><th width="586">Property Value</th></tr></thead><tbody><tr><td><code>name</code></td><td><code>context.segment_name</code></td></tr><tr><td><code>description</code></td><td><code>context.site_id</code>_<code>context.segment_id</code>_<code>context.segment_name</code></td></tr><tr><td><code>type</code></td><td>custom_ids</td></tr><tr><td><code>nb_ids</code></td><td>(Number of identifiers in segment)</td></tr><tr><td><code>indexing_state</code></td><td>APPLIED</td></tr><tr><td><code>created</code></td><td>(Creation time in the format YYYY-MM-DDTHH:MM:SS)</td></tr><tr><td><code>updated</code></td><td>(Update time in the format YYYY-MM-DDTHH:MM:SS)</td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.commandersact.com/features/destinations/destinations-catalog/batch.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.