LinkedIn destination

​

What this is

​

Prerequisites

​

Supported identifiers and actions

import hashlib

def sha256_email(email: str) -> str:
    return hashlib.sha256(email.strip().lower().encode("utf-8")).hexdigest()

sha256_email("Alice@Example.com")
# returns a 64-character lowercase hex SHA256 digest

​

Create the LinkedIn destination

1. Sign in to the Zeotap CDP App and open the Destinations application.

2. Click + Create Destination, then under All Channels search for LinkedIn and select it.

3. Configure the destination details:
   • Enter a name for the destination.
   • Enter the Client name — a placeholder label your team will recognise when listing destinations.
   • Click Connect LinkedIn.

4. You are redirected to LinkedIn. Sign in with the account that has access to the target Ad Account and accept the requested permissions.

5. Choose the Ad Account to bind this destination to. The Access Token and Refresh Token populate automatically along with each token’s expiry date.

6. Click Next to proceed to mapping.
7. Under Choose your Action, select Send identifiers to LinkedIn. Under Map the Fields, select the identifiers to send (SHA256 emails, MAIDs, or both). The default list shows the output identifiers accepted by the platform; edit, add, or remove entries as needed. See Destinations → Mappings for mapping rules.

8. Click Create Destination. The new destination is listed in the Audiences application, ready to be linked to an audience or segment.

​

Link an audience to the destination

​

Verify the audience reached LinkedIn

1. Sign in to LinkedIn Campaign Manager and open Audiences.

2. Locate the audience by the name you gave it in Zeotap and check three fields:
   • Match rate — the percentage of your uploaded list that matched LinkedIn members for contact targeting. See LinkedIn’s Match rate documentation.
   • Status — indicates whether the audience is ready to be used or needs attention. An audience must reach the ready-to-use state before you can attach it to a campaign.
   • Last modified — timestamp of the last update from Zeotap. A value within your audience refresh window confirms the latest sync landed.

​

Attach the audience to a campaign

1. In LinkedIn Campaign Manager, open Advertise → Campaigns.
2. Under the Campaigns tab, click Create → Campaign.

3. Confirm the pre-filled Campaign Group settings and click Next.

4. Under Who is your target audience?, click Audiences → Third party → Third Party Contact.

5. Select the Zeotap segment and continue with the rest of the campaign setup.

​

Maintain access and refresh tokens

• Access Token — valid for 60 days. Zeotap renews it automatically using the Refresh Token.
• Refresh Token — valid for 1 year. When the Refresh Token expires, the destination owner must reauthorise the destination.

​

How user disqualification works

​

Troubleshoot connection and token issues

​

Why this happens

​

Resolve token expiry or revocation

1. In Zeotap, open the Destinations application and select the affected LinkedIn destination.
2. Recreate the destination by running the OAuth flow from Create the LinkedIn destination again. The new token pair replaces the expired or revoked pair.
3. Reattach the destination to the affected audiences if the original destination was removed.

​

Resolve a low or zero match rate

1. Confirm your source identifiers are SHA256-hashed emails or MAIDs (Google AID). LinkedIn rejects unhashed email values for this integration.
2. Re-hash emails over the lowercased, trimmed value (see the snippet in Prerequisites).
3. Trigger an audience refresh and recheck the Match rate in LinkedIn Campaign Manager 48 hours later.

​

When to contact support

• You completed the OAuth flow but the destination remains in an error state after one full refresh cycle.
• The audience appears in LinkedIn Campaign Manager but the Match rate stays at 0% after a second refresh with correctly-hashed identifiers.
• You see a destination behaviour not described on this page.

• The destination name and the LinkedIn Ad Account ID.
• The audience name and ID.
• Timestamp of the last successful refresh (from the Audiences listing).
• The current token expiry date shown in the destination configuration.
• A screenshot of the Match rate, Status, and Last modified columns from LinkedIn Campaign Manager → Audiences.

​

FAQ

​

Next steps

• Explore audience linking → Link an audience to the destination
• Explore identifier coverage → Extend your audience with ID Extension
• Explore output identifier choices → Choose the output identifiers
• Explore delta and delete behaviour → Delta upload and delete functions
• Explore the full destination catalog → Integrations master list