Conversions API Workflow

Warning

Deprecation Notice: The Marketing Version 202511 (Marketing November 2025) will be sunset on November 16, 2026. We recommend that you migrate to the latest versioned APIs to avoid disruptions. For information on all the supported versions, refer to the migrations documentation. If you haven’t yet migrated and have questions, submit a request on the LinkedIn Developer Support Portal.

API Workflow

Step 1: Generate a 3-legged access token

Generate a 3-legged member access token to obtain user authorization for consent to create and manage conversions using rw_conversions and r_ads permissions in the scope.

For direct advertiser builds, see set up and create conversions using Direct API. For partners, see Authorization Code Flow (3-legged OAuth).

Step 2: Retrieve Authenticated User's Ad Accounts

1. Retrieve all sponsored ad accounts of the authenticated user where the user doesn't have a VIEWER role on the ad account.
2. Prompt the user to select one of their ad accounts where conversion events should be streamed. Save the selected ad account URN for subsequent requests. For additional details, refer to Find Ad Accounts by Authenticated User.

Step 3: Fetch Existing Conversions API Rules in the Selected Ad Account

1. Fetch all active Conversions API conversion rules available in the selected ad account.
2. Use request query parameter enabled=true to filter out deleted conversion rules, and conversionMethod=CONVERSIONS_API to filter Conversions API-specific rules.
3. Allow the user to choose whether to create a new Conversion Rule or update an existing one. If updating, prompt the user to select an existing conversion rule (based on display name, type, and status) for streaming conversion events. Save the selected conversion URN for future requests. For more information, please see Find Conversion Rules by Ad Account.

Step 4: Optional (Skip This Step if Updating an Existing Rule): Create a New Conversion Rule

1. Create a new conversion rule in the selected ad account. Each conversion rule should include conversion name, ad account URN, conversion method, and type (key conversion behavior). We recommend using the request query parameter autoAssociationType=ALL_CAMPAIGNS to associate the conversion rule with all ad campaigns. Conversions are only attributed for the associated ad campaigns.

2. Once created, save the newly created conversion ID for subsequent requests. For more information, please see Create a Conversion Rule.

The created conversion rule should also appear on Campaign Manager > Ad Account > Measurement > Conversion Tracking.

Conversion rules can also be created directly from the Campaign Manager UI. For more information, please see Setup a Conversions API Integration in Campaign Manager.

Step 5: Stream Conversion Events to the Conversion Rule

Stream conversion events to the conversion rule previously created or fetched, and send all available user identifiers for matching with LinkedIn. For the list of supported user identifiers, see User Schema.

For more information, see Adding Multiple Conversion Events in a Batch. To learn more about recommended best practices, see Conversions API Best Practices.