feat(linkedin-conversions): upgrade API to 202603 behind feature flag (#3709)

- Add LINKEDIN_CONVERSIONS_CANARY_API_VERSION = '202603' to versioning-info.ts
- Add FLAGON_NAME and getApiVersion() helper to constants.ts
- Update extendRequest in index.ts to use getApiVersion(features)
- Add feature flag tests for both stable (202505) and canary (202603) versions
- All 45 tests passing

Version 202505 sunsets May 15, 2026. No breaking changes between 202505 and 202603.

Co-authored-by: Claude Sonnet 4.6 <[email protected]>

Author: harsh-joshi99

packages/destination-actions/src/destinations/linkedin-conversions/constants.ts

@@ -1,7 +1,14 @@
 import { DependsOnConditions } from '@segment/actions-core/destination-kit/types'
-import { LINKEDIN_CONVERSIONS_API_VERSION } from './versioning-info'
+import { Features } from '@segment/actions-core'
+import { LINKEDIN_CONVERSIONS_API_VERSION, LINKEDIN_CONVERSIONS_CANARY_API_VERSION } from './versioning-info'
 
 export const LINKEDIN_API_VERSION = LINKEDIN_CONVERSIONS_API_VERSION
+export const LINKEDIN_CANARY_API_VERSION = LINKEDIN_CONVERSIONS_CANARY_API_VERSION
+export const FLAGON_NAME = 'linkedin-conversions-canary-version'
+
+export function getApiVersion(features?: Features): string {
+  return features && features[FLAGON_NAME] ? LINKEDIN_CANARY_API_VERSION : LINKEDIN_API_VERSION
+}
 export const BASE_URL = 'https://api.linkedin.com/rest'
 export const LINKEDIN_SOURCE_PLATFORM = 'SEGMENT'
 

packages/destination-actions/src/destinations/linkedin-conversions/index.ts

@@ -3,7 +3,7 @@ import { InvalidAuthenticationError, IntegrationError, ErrorCodes } from '@segme
 import type { Settings } from './generated-types'
 import { LinkedInConversions } from './api'
 import type { LinkedInTestAuthenticationError, RefreshTokenResponse, LinkedInRefreshTokenError } from './types'
-import { LINKEDIN_API_VERSION } from './constants'
+import { getApiVersion } from './constants'
 import https from 'https'
 import streamConversion from './streamConversion'
 
@@ -88,7 +88,7 @@ const destination: DestinationDefinition<Settings> = {
       return { accessToken: res?.data?.access_token }
     }
   },
-  extendRequest({ auth }) {
+  extendRequest({ auth, features }) {
     // Repeat calls to the same LinkedIn API endpoint were failing due to a `socket hang up`.
     // This seems to fix it: https://stackoverflow.com/questions/62500011/reuse-tcp-connection-with-node-fetch-in-node-js
     // Copied from LinkedIn Audiences extendRequest, which also ran into this issue.
@@ -97,7 +97,7 @@ const destination: DestinationDefinition<Settings> = {
     return {
       headers: {
         authorization: `Bearer ${auth?.accessToken}`,
-        'LinkedIn-Version': LINKEDIN_API_VERSION,
+        'LinkedIn-Version': getApiVersion(features),
         'X-Restli-Protocol-Version': `2.0.0`
       },
       agent

packages/destination-actions/src/destinations/linkedin-conversions/streamConversion/__tests__/index.test.ts

@@ -1,7 +1,7 @@
 import nock from 'nock'
 import { createTestEvent, createTestIntegration } from '@segment/actions-core'
 import { DynamicFieldResponse } from '@segment/actions-core'
-import { BASE_URL } from '../../constants'
+import { BASE_URL, FLAGON_NAME, LINKEDIN_API_VERSION, LINKEDIN_CANARY_API_VERSION } from '../../constants'
 import Destination from '../../index'
 
 const testDestination = createTestIntegration(Destination)
@@ -709,6 +709,80 @@ describe('LinkedinConversions.dynamicField', () => {
   })
 })
 
+describe('LinkedinConversions.apiVersion feature flag', () => {
+  it('should use stable API version (202505) by default', async () => {
+    nock(`${BASE_URL}/conversionEvents`)
+      .post('', {
+        conversion: 'urn:lla:llaPartnerConversion:789123',
+        conversionHappenedAt: currentTimestamp,
+        user: {
+          userIds: [
+            {
+              idType: 'SHA256_EMAIL',
+              idValue: '584c4423c421df49955759498a71495aba49b8780eb9387dff333b6f0982c777'
+            }
+          ]
+        }
+      })
+      .matchHeader('LinkedIn-Version', LINKEDIN_API_VERSION)
+      .reply(201)
+
+    await expect(
+      testDestination.testAction('streamConversion', {
+        event,
+        settings,
+        mapping: {
+          email: { '@path': '$.context.traits.email' },
+          conversionHappenedAt: { '@path': '$.timestamp' },
+          onMappingSave: {
+            inputs: {},
+            outputs: { id: payload.conversionId }
+          },
+          enable_batching: true,
+          batch_size: 5000
+        }
+        // no features = stable version
+      })
+    ).resolves.not.toThrowError()
+  })
+
+  it('should use canary API version (202603) when feature flag is enabled', async () => {
+    nock(`${BASE_URL}/conversionEvents`)
+      .post('', {
+        conversion: 'urn:lla:llaPartnerConversion:789123',
+        conversionHappenedAt: currentTimestamp,
+        user: {
+          userIds: [
+            {
+              idType: 'SHA256_EMAIL',
+              idValue: '584c4423c421df49955759498a71495aba49b8780eb9387dff333b6f0982c777'
+            }
+          ]
+        }
+      })
+      .matchHeader('LinkedIn-Version', LINKEDIN_CANARY_API_VERSION)
+      .reply(201)
+
+    await expect(
+      testDestination.testAction('streamConversion', {
+        event,
+        settings,
+        mapping: {
+          email: { '@path': '$.context.traits.email' },
+          conversionHappenedAt: { '@path': '$.timestamp' },
+          onMappingSave: {
+            inputs: {},
+            outputs: { id: payload.conversionId }
+          },
+          enable_batching: true,
+          batch_size: 5000
+        },
+        features: { [FLAGON_NAME]: true }
+      })
+    ).resolves.not.toThrowError()
+  })
+})
+
 describe('LinkedinConversions.timestamp', () => {
   it('should convert a human readable date to a unix timestamp', async () => {
     event.timestamp = currentTimestamp.toString()

packages/destination-actions/src/destinations/linkedin-conversions/versioning-info.ts

@@ -1,5 +1,13 @@
 /** LINKEDIN_CONVERSIONS_API_VERSION
- * LinkedIn Conversions API version.
+ * LinkedIn Conversions API version (stable/production).
  * API reference: https://learn.microsoft.com/en-us/linkedin/marketing/integrations/ads-reporting/conversions-api?view=li-lms-2025-05&tabs=curl
+ * Changelog: https://learn.microsoft.com/en-us/linkedin/marketing/changelog
  */
 export const LINKEDIN_CONVERSIONS_API_VERSION = '202505'
+
+/** LINKEDIN_CONVERSIONS_CANARY_API_VERSION
+ * LinkedIn Conversions API version (canary/feature-flagged).
+ * Testing new version 202603 behind feature flag.
+ * Version 202505 sunsets May 15, 2026.
+ */
+export const LINKEDIN_CONVERSIONS_CANARY_API_VERSION = '202603'