--- title: Upgrading an existing deployment description: If you're upgrading from a previous version of the LinkedIn Login Integration Kit, you might need to take extra steps. component: linkedin page_id: linkedin:setup:pf_linkedin_cic_upgrading_an_existing_deployment canonical_url: https://docs.pingidentity.com/integrations/linkedin/setup/pf_linkedin_cic_upgrading_an_existing_deployment.html revdate: July 22, 2025 section_ids: steps: Steps --- # Upgrading an existing deployment If you're upgrading from a previous version of the LinkedIn Login Integration Kit, you might need to take extra steps. ## Steps 1. Back up your current PingFederate configuration as shown in [Configuration archive](https://docs.pingidentity.com/pingfederate/latest/administrators_reference_guide/help_configurationarchivetasklet_selectimportexportstate.html) in the PingFederate documentation. 2. If you're upgrading from LinkedIn IdP Adapter 2.2 or earlier: 1. Note your adapter instance configuration. 2. Delete the adapter instance. 3. Complete the steps in [Deploying the integration files](pf_linkedin_cic_deploying_the_integration_files.html). 4. Complete the steps in [Configuring an adapter instance](pf_linkedin_cic_configuring_an_adapter_instance.html). Configure the adapter instance settings based on your notes, making the following changes: | | | | - | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | * Update the **LinkedIn User Data v2 URL** field * Related Change: The `https://api.linkedin.com/v2/me` API endpoint that the LinkedIn IdP Adapter used to retrieve user information in LinkedIn Login Integration Kit 2.2 and earlier is now unavailable. * Required Action: When you upgrade the LinkedIn IdP Adapter, make sure the **LinkedIn User Data v2 URL** field contains the new API URL, `https://api.linkedin.com/v2/userinfo`. Learn more in [LinkedIn IdP Adapter settings](pf_linkedin_cic_linkedin_idp_adapter_settings.html). * Update the **Permissions** field * Related Change: The API endpoint that the LinkedIn IdP Adapter used to retrieve email addresses is now unavailable. As a result, LinkedIn Login Integration Kit 3.0 has deprecated the **LinkedIn User Email V2 URL** field and the `r_emailadress`, `r_liteprofile`, and `r_fullprofile` permissions. * Required Action: Make sure the **Permissions** field contains the new default permissions, `profile`, `openid`, and `email`. Learn more in [LinkedIn IdP Adapter settings](pf_linkedin_cic_linkedin_idp_adapter_settings.html). Additionally, you can find a sample user information payload using the new API URL and permissions in [JSON Pointer syntax reference](pf_linkedin_cic_json_pointer_syntax_reference.html). * Check Optional LinkedIn Attributes * Related Change: If you mapped any attributes in the **Optional LinkedIn Attributes** section when configuring an adapter instance, your configuration might be broken or no longer relevant. * Required Action: Review your adapter configuration and fix any errors reported during the connection test. Learn more in [Configuring an adapter instance](pf_linkedin_cic_configuring_an_adapter_instance.html). * Update any configurations using the `id` core contract attribute * Related Change: LinkedIn Login Integration Kit 3.0 has replaced the `id` core contract attribute with the `sub` core contract attribute to align with the response body schema described in [Sign In with LinkedIn using OpenID Connect](https://learn.microsoft.com/en-us/linkedin/consumer/integrations/self-serve/sign-in-with-linkedin-v2). * Required Action: Review your authentication policy and connection configuration. Change all instances of `id` to `sub`. Learn more in [Core contract attributes](pf_linkedin_cic_core_contract_attributes.html). |