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

# Beeswax

> Combine best-in-breed solutions from across the programmatic ecosystem with your proprietary data, algorithms, and strategies into a seamless whole

## Setup

After selecting Beeswax from our destinations catalog, you will be required to enter your *Beeswax Subdomain*,
*Email*, and *Password* from your Beeswax account. Your *Beeswax Subdomain* is the text before `.beeswax.com` in
the URL, *Username* and *Password* are the credentials you use to login to Beeswax.

Optionally you can also add a salt that is provided by Beeswax that will be used when hashing data used for [HEM](#hem) identifiers.

## Syncing segments

Hightouch supports automatically creating a new segment for your sync. You can optionally assign a custom name to your segment.
If no name is provided, Hightouch will default to using your model name.

Here, the model name `User Segment 1` will be used as the segment name:

![](https://mintcdn.com/hightouch-3c037897/L_vQfA0JQEpeGUUo/images/destinations/destination-beeswax-create-segment.png?fit=max\&auto=format\&n=L_vQfA0JQEpeGUUo\&q=85\&s=1a54c52d208147b90cafb722ba29f33c)

Additionally, instead of creating a new segment, Hightouch can also sync users to existing segments that are already populated in your Beeswax account.

![](https://mintcdn.com/hightouch-3c037897/L_vQfA0JQEpeGUUo/images/destinations/destination-beeswax-existing-segment.png?fit=max\&auto=format\&n=L_vQfA0JQEpeGUUo\&q=85\&s=bcb2ea43c18f8e4884aaac1e2d6e5677)

### Sync modes

This integration supports Segment mode. New records will be inserted into a Beeswax segment. Records that are removed from the model will be removed from the
segment.

### Select Beeswax sync options

Hightouch allows you to choose which Beeswax account and data center you wish to sync data to. This can be selected on the sync configuration page.

![](https://mintcdn.com/hightouch-3c037897/L_vQfA0JQEpeGUUo/images/destinations/destination-beeswax-account-options.png?fit=max\&auto=format\&n=L_vQfA0JQEpeGUUo\&q=85\&s=55a6d38d5f124e1b0cfe27af31ec77d7)

### Record mappings

Records can be matched from your source to your segment by `Beeswax ID`, `Customer ID`, `HEM`, `IDFA`, `IDFA_MD5`, `IDFA_SHA1`, `AD_ID`, `AD_ID_MD5`, `AD_ID_SHA1`, or `IP_ADDRESS`.

![](https://mintcdn.com/hightouch-3c037897/L_vQfA0JQEpeGUUo/images/destinations/destination-beeswax-record-mapping.png?fit=max\&auto=format\&n=L_vQfA0JQEpeGUUo\&q=85\&s=49af08c46c6c74a435d8c89494e732f0)

#### HEM

When using HEM as the matching type, the mapped value will automatically be hashed based on the [docs](https://hub.freewheel.tv/display/BW/Hashed+Email+Addresses+in+FreeWheel+Identity+Network).
You can turn this off using the checkbox if your IDs are already hashed.

![](https://mintcdn.com/hightouch-3c037897/L_vQfA0JQEpeGUUo/images/destinations/destination-beeswax-toggle-hash.png?fit=max\&auto=format\&n=L_vQfA0JQEpeGUUo\&q=85\&s=d6dab41daaa1431a7dd22e1e6b6b8b5c)

## Tips and troubleshooting

To see the exact API requests and responses from each sync run, use the [live debugger](https://docs.hightouch.com/syncs/debugger.md). To get notified by Slack, PagerDuty, SMS, or email when a sync fails, set up [sync alerts](https://docs.hightouch.com/syncs/alerting.md). If you run into an issue this page doesn't cover, [contact support](#pylon-chat).