# Sync Audiences to LinkedIn Audience


##  Setup

1. Set up an audience in RudderStack using the [Audience Builder]({{< ref "audiences/audience-builder/create-audience.md" >}}).
2. Go to the **Syncs** tab of the audience page and click **Add sync**. Then, select **LinkedIn Audience**.
3. Click **New destination** — you can also select an already-configured destination here.
4. Specify a unique name to identify this destination in RudderStack.
5. In the **Event delivery account** section, click **Select** to choose from an existing LinkedIn account from the list. You can also click **Add account** and authenticate via OAuth, by specifying the following settings:

| Setting | <div style="width: 350px;">Description</div> |
| :----| :-----|
| Account Name | Specify a unique account name |
| oAuth settings | Click **Connect account**, sign in with LinkedIn, and give RudderStack the required permissions to access your LinkedIn Ads account. |

6. Proceed to configure the mapping settings.

## Configure sync

This section lists the settings to correctly configure your audience syncs to the LinkedIn Audience destination.

### Select LinkedIn account

Select your LinkedIn Ads account from the dropdown — all the data will be synced with this account.

### Audience type

Select the audience type from the dropdown. Two types are supported - **User** and **Company**.

### Select audience

In this section, you can create a new audience or use an existing one.

- **Create new audience**: Use this option to create a new custom audience in LinkedIn. You can specify the name and description of the new LinkedIn audience.
- **Use existing audience**: Select an existing audience in LinkedIn. This field is populated based on your [connection settings](#setup) and audience type.

### Sync mode

RudderStack supports only [Mirror mode]({{< ref "data-pipelines/reverse-etl/developer-guides/sync-modes.md#mirror-mode" >}}) for this integration.

### Mapping settings

1. Select warehouse columns that act as identifiers for your records and map them to LinkedIn identifiers based on your audience type — see [Identifier mappings](#identifier-mappings) for more information.
2. Map the other warehouse columns to specific LinkedIn fields that represent your audience's identity.

{{< image src="images/audiences/destinations/linkedin/map-identifier-syncs.webp" >}}

#### Identifier mappings

{{< success >}}
Multiple identifiers are supported for both the **User** and **Company** audience types.
{{< /success >}}

- For the **User** audience type, the following LinkedIn identifiers are supported to which you can map your warehouse columns:

| Identifier | <div style="width: 350px;">Description</div> |
| :----| :----|
| Email (SHA256) |  User's email in a hex-encoded string format with a maximum length of 64 characters. |
| Email (SHA512) |  User's email in a hex-encoded string format with a maximum length of 128 characters. | 
| [Google Advertising ID](https://support.google.com/googleplay/android-developer/answer/6048248?hl=en) | Plain text string (in lower case) with a maximum length of 32 characters. |

- For the **Company** audience type, the following identifiers are supported:

| Identifier | <div style="width: 350px;">Description</div> |
| :----| :----|
| Company Name | The company name. | 
| Company Email Domain | Company's email domain  string in a URL format, for example, `linkedin.com`. |
| Company Website Domain | Company's website domain string in a URL format, for example, `www.linkedin.com`. |
| Company Page URL | The LinkedIn company page URL with a maximum length of 100 characters, for example, `linkedin.com/company/acmecorp`. |
| Organization URN | The LinkedIn company page URN, for example, `urn:li:organizationUrn:123`. |

#### Other mappings

Apart from the [identifier mappings](#identifier-mappings), the **User** audience type also supports the below field mappings:

| Field | <div style="width: 350px;">Description</div> |
| :----| :----|
| First Name  | User's first name with a maximum length of 35 characters, for example, `Alex`. | 
| Last Name | User's last name with a maximum length of 35 characters, for example, `Keener`. | 
| Title | User's title in the company with a maximum length of 50 characters, for example, `Engineer`. | 
| Company | User's company name with a maximum length of 50 characters, for example, `Acme Corp`. |
| Country | ISO standard two letter country code, for example, `US`. | 

For the **Company** audience type, The following field mappings are supported:

| Field | <div style="width: 350px;">Description</div> |
| :----| :----|
| Stock Symbol | Stock symbol of the company with a maximum length of 5 letters, for example, `ACME`. | 
| Industries | Three industry names for the company with a maximum length of 50 characters, for example, `Technology`, `Software`. | 
| City | City of the company with a maximum length of 50 characters, for example, `New York`. | 
| State | State or province of the company with a maximum length of 50 characters, for example, `Louisiana`. |
| Country | ISO standard two letter country code, for example, `US`. | 
| Postal Code | Postal code of the company with a maximum length of 20 characters, for example, `560001`. | 

### Advanced settings

| Setting | <div style="width: 350px;">Description</div> |
| :----| :-----|
| Automatically hash PII data | When set to **Yes**, User data is hash-encoded before sending to LinkedIn. <br /><br />**Note that**: <ul><li>This setting is applicable only for the **User** audience type.</li><li>**Do not use** this setting if you are syncing already-hashed data from your warehouse to LinkedIn. Otherwise, it can lead to failures. See [Data hashing](#data-hashing) section for more information.</li></ul> |

## Sync settings

{{< customreadfile "/includes/audiences/sync-settings.md" >}}

## Enable sync

{{< customreadfile "/includes/audiences/enable-sync.md" >}}

## Data hashing

The [Automatically hash PII data](#advanced-settings) setting lets you hash your user data before sending it to LinkedIn. This setting is enabled by default.

- Configure the setting to **Yes** if your incoming data is not pre-hashed
- Configure this setting to **No** if your data is already hashed

{{< warning >}}
Incorrect configuration of the **Automatically hash PII data** setting will result in failures.

- If the **Automatically hash PII data** setting is configured to **Yes** and your data is pre-hashed, the event will fail.
- If the **Automatically hash PII data** setting is configured to **No** and your data is not pre-hashed, the event will fail.
{{< /warning >}}

Such events are rejected with a clear error message, for example:

```text
Automatically hash PII data is disabled but the value for field EMAIL appears to be unhashed. Either enable hashing or send pre-hashed data.
```

You will also see errors in the **Events** tab for cases that were previously marked as successful but resulted in no matches, helping you identify and fix data quality or configuration issues.