---
title: Upgrading an existing deployment
description: If you're upgrading from a previous version of the Facebook Login Integration Kit, back up your PingFederate configuration and note your adapter configuration.
component: facebook
page_id: facebook:facebook_login_integration_kit:pf_facebook_cic_upgrading_an_existing_deployment
canonical_url: https://docs.pingidentity.com/integrations/facebook/facebook_login_integration_kit/pf_facebook_cic_upgrading_an_existing_deployment.html
revdate: January 20, 2026
section_ids:
  steps: Steps
---

# Upgrading an existing deployment

If you're upgrading from a previous version of the Facebook Login Integration Kit, back up your PingFederate configuration and note your adapter configuration.

## Steps

1. Back up your current PingFederate configuration as shown in [Exporting an archive](https://docs.pingidentity.com/pingfederate/latest/administrators_reference_guide/help_configurationarchivetasklet_configurationarchiveexportstate.html) in the PingFederate documentation.

2. On the PingFederate admin console, note the following from your adapter instance configuration:

   * Scope permissions

   * Extended contract attributes

   * Attribute mappings

3. Complete the steps in [Deploying the integration files](pf_facebook_cic_deploying_the_integration_files.html).

4. In the PingFederate admin console, go to **Authentication > Integration > IdP Adapters**. Select your IdP adapter instance to open it.

5. Restore the configuration settings that you noted.

6. If any of the following scope permissions in the **Scope Permissions** section are blank, configure it again, and then click **Update**:

   * `email`

   * `user_hometown`

   * `user_location`

7. In **Advanced Configuration Fields** section, update the API version numbers in the following endpoints:

   * **Facebook Authentication URL**

   * **Facebook Access Token URL**

   * **Facebook User Data URL**

   For example, change `https://graph.facebook.com/v2.2/me` to `https://graph.facebook.com/v8.0/me`.

   You can find a list of available API versions in the [Graph API Changelog](https://developers.facebook.com/docs/graph-api/changelog/) in the Facebook documentation.

   To automatically use the oldest available version of the API, remove the `/v2.2` or equivalent portion of the URL. For example, `https://graph.facebook.com/me`.

8. Remove any query parameters from the **Facebook User Data URL** field.

   For example, change `https://graph.facebook.com/me?fields=id,birthday,email` to `https://graph.facebook.com/me`.

9. On the **Extended Contract** tab, add any non-core attributes that you want to include in the contract, such as those associated with additional permissions that you configured.

   If you upgraded from a previous version of the Facebook IdP Adapter, add any attributes that were previously configured but are no longer part of the core contract.

   You can find a list of core contract attributes in [Core contract attributes reference](pf_facebook_cic_core_contract_attributes_reference.html).

10. On the **Adapter Attributes** tab, set pseudonym and masking options as shown in [Set pseudonym and masking options](https://docs.pingidentity.com/pingfederate/latest/administrators_reference_guide/pf_setting_pseudonym_masking_options.html) in the PingFederate documentation. Click **Next**.

11. On the **Adapter Contract Mapping** tab, configure the contract fulfillment details for the adapter as shown in [Define the IdP adapter contract](https://docs.pingidentity.com/pingfederate/latest/administrators_reference_guide/help_authnadapterinstancetasklet_plugincontractstate.html) in the PingFederate documentation. Remap any attributes Facebook has deprecated that you want to continue using. Click **Next**.

12. Click **Save**.