Transactional calls with LinkedIn Ads audiences

The connection proxy lets you call LinkedIn’s API directly through a Polytomic LinkedIn Ads Connection. Polytomic authenticates the request and injects the required LinkedIn headers automatically — you only need to supply the method, path, and body.

Set your Polytomic API key as an environment variable:

export POLYTOMIC_API_KEY=YOUR-API-TOKEN

Proxy info

Call GET /api/connections/{id}/proxy/info to inspect the inherited base URL, locked headers, allowed methods, and rate limits before building requests dynamically.

1. Get a DMP segment

Retrieve a single DMP segment by ID.

cURL

Python

Typescript

Go

curl --request POST \
     --url "https://app.polytomic.com/api/connections/${LINKEDIN_CONNECTION_ID}/proxy" \
     --header "accept: application/json" \
     --header "content-type: application/json" \
     --header "X-Polytomic-Version: 2025-09-18" \
     --header "Authorization: Bearer ${POLYTOMIC_API_KEY}" \
     -d '{
       "request": {
         "method": "GET",
         "path": "/dmpSegments/11204"
       }
     }'

2. Get multiple DMP segments

Retrieve several segments in one call using LinkedIn’s ids=List(...) query syntax. Use rawQuery instead of query for non-standard query strings like this one.

cURL

Python

Typescript

Go

curl --request POST \
     --url "https://app.polytomic.com/api/connections/${LINKEDIN_CONNECTION_ID}/proxy" \
     --header "accept: application/json" \
     --header "content-type: application/json" \
     --header "X-Polytomic-Version: 2025-09-18" \
     --header "Authorization: Bearer ${POLYTOMIC_API_KEY}" \
     -d '{
       "request": {
         "method": "GET",
         "path": "/dmpSegments",
         "rawQuery": "ids=List(10804,10814)"
       }
     }'

3. Add or remove a company audience member

Add or remove a single company from a DMP segment.

cURL

Python

Typescript

Go

curl --request POST \
     --url "https://app.polytomic.com/api/connections/${LINKEDIN_CONNECTION_ID}/proxy" \
     --header "accept: application/json" \
     --header "content-type: application/json" \
     --header "X-Polytomic-Version: 2025-09-18" \
     --header "Authorization: Bearer ${POLYTOMIC_API_KEY}" \
     -d '{
       "request": {
         "method": "POST",
         "path": "/dmpSegments/10804/companies",
         "body": {
           "action": "ADD",
           "companyName": "LinkedIn",
           "companyWebsiteDomain": "linkedin.com",
           "companyPageUrl": "www.linkedin.com/company/linkedin",
           "stockSymbol": "MSFT",
           "industries": ["information technology", "software"],
           "city": "Seattle",
           "state": "WA",
           "country": "US"
         }
       }
     }'

4. Batch add or remove companies

Add or remove multiple companies in a single request. Pass X-RestLi-Method: BATCH_CREATE as a per-request header via request.headers.

cURL

Python

Typescript

Go

curl --request POST \
     --url "https://app.polytomic.com/api/connections/${LINKEDIN_CONNECTION_ID}/proxy" \
     --header "accept: application/json" \
     --header "content-type: application/json" \
     --header "X-Polytomic-Version: 2025-09-18" \
     --header "Authorization: Bearer ${POLYTOMIC_API_KEY}" \
     -d '{
       "request": {
         "method": "POST",
         "path": "/dmpSegments/10804/companies",
         "headers": {
           "X-RestLi-Method": "BATCH_CREATE"
         },
         "body": {
           "elements": [
             {"action": "ADD", "companyName": "LinkedIn"},
             {"action": "ADD", "companyName": "Microsoft"}
           ]
         }
       }
     }'

5. Batch add or remove users

Add multiple users to a segment in one request. Each element can carry one or more identity types (SHA256_EMAIL, GOOGLE_AID, etc.) and optional profile attributes.

cURL

Python

Typescript

Go

curl --request POST \
     --url "https://app.polytomic.com/api/connections/${LINKEDIN_CONNECTION_ID}/proxy" \
     --header "accept: application/json" \
     --header "content-type: application/json" \
     --header "X-Polytomic-Version: 2025-09-18" \
     --header "Authorization: Bearer ${POLYTOMIC_API_KEY}" \
     -d '{
       "request": {
         "method": "POST",
         "path": "/dmpSegments/10804/users",
         "body": {
           "elements": [
             {
               "action": "ADD",
               "userIds": [
                 {"idType": "SHA256_EMAIL", "idValue": "692682111bc191d915ac7009d118a78bc496cf7a2ba8c2d0134ade012ac1234"},
                 {"idType": "GOOGLE_AID",   "idValue": "cffg876e-gm9v-98de-0013d927s873"}
               ]
             },
             {
               "action": "ADD",
               "userIds": [
                 {"idType": "SHA256_EMAIL", "idValue": "09d118a78b69261bc191d915ac70c496cf7a9e0502ba8c2d016f2f134ade"},
                 {"idType": "GOOGLE_AID",   "idValue": "cdda802e-12cd-fb9c-47ad-0794d394c912"}
               ],
               "firstname": "mike",
               "lastname": "smith"
             }
           ]
         }
       }
     }'

6. Add or remove a single user

Add or remove one user from a segment, optionally including profile attributes to improve match rates.

cURL

Python

Typescript

Go

curl --request POST \
     --url "https://app.polytomic.com/api/connections/${LINKEDIN_CONNECTION_ID}/proxy" \
     --header "accept: application/json" \
     --header "content-type: application/json" \
     --header "X-Polytomic-Version: 2025-09-18" \
     --header "Authorization: Bearer ${POLYTOMIC_API_KEY}" \
     -d '{
       "request": {
         "method": "POST",
         "path": "/dmpSegments/10804/users",
         "body": {
           "action": "ADD",
           "userIds": [
             {"idType": "SHA256_EMAIL", "idValue": "09d118a78b69261bc191d915ac70c496cf7a9e0502ba8c2d016f2f134ade"},
             {"idType": "GOOGLE_AID",   "idValue": "cdda802e-fb9c-47ad-0794d394c912"}
           ],
           "firstname": "mike",
           "lastname": "smith",
           "titleName": "software engineer",
           "companyName": "microsoft",
           "countryName": "us"
         }
       }
     }'

7. Create a DMP segment

Create a new DMP segment and associate it with a LinkedIn Ads account.

cURL

Python

Typescript

Go

curl --request POST \
     --url "https://app.polytomic.com/api/connections/${LINKEDIN_CONNECTION_ID}/proxy" \
     --header "accept: application/json" \
     --header "content-type: application/json" \
     --header "X-Polytomic-Version: 2025-09-18" \
     --header "Authorization: Bearer ${POLYTOMIC_API_KEY}" \
     -d '{
       "request": {
         "method": "POST",
         "path": "/dmpSegments",
         "body": {
           "name": "DMP Segment 1",
           "sourcePlatform": "DMP_PARTNER_PLATFORM",
           "account": "urn:li:sponsoredAccount:516848833",
           "type": "USER",
           "destinations": [
             {"destination": "LINKEDIN"}
           ]
         }
       }
     }'