Transferring an Integration

Transferring an Integration

You can transfer your installation of a Native Integration from one Vercel team to another. The transfer moves the installation, the resources it owns, and any prepayment balances and thresholds. Vercel also notifies the integration provider so they can update their own records.

This page covers transfers you start from the integration's Manage page. If you only need to move a single resource (for example, one database) instead of the whole installation, see Transfer a resource to another team. To move a project that depends on an integration, see Transferring projects.

Before you start

Make sure each of the following is true. If any check fails, you see an error and the transfer does not proceed.

Check Where to fix it
You are an Owner or Member of the target team Ask a team Owner to add you
Your role on the source team allows you to remove this integration Ask a team Owner to update your role
The integration is a Native Integration, not a Connectable Account Connectable accounts cannot use this flow
The integration supports transfer Some integrations do not support transfer. Contact the integration provider
The target team does not already have this integration installed Uninstall it on the target team first
No active project on the source team is connected to a resource owned by this integration Disconnect each project from each resource before starting
The source team has no unpaid invoices for this integration Pay or void any open invoices
No integration store on the source team has a name that conflicts with an existing resource on the target team Rename the conflicting resource on the target team
For paid integrations, the target team has a payment method on file Add a payment method in the target team's billing settings

If the Transfer Integration section does not appear on the integration's Settings page, the integration does not support transfer.

If the Transfer Integration button is disabled, your role on the source team does not allow transferring this integration. Hover the button for the exact reason, then ask a team Owner to update your role.

If the button works but you see "Feature not enabled for your team" after confirming the transfer, the marketplace transfer feature is not enabled for your source team. Contact Vercel Support to request access.

What happens to your projects

Because the transfer requires you to disconnect every project from this integration's resources before starting, projects on the source team lose access to the integration as you disconnect them. Vercel removes the integration's environment variables from each disconnected project.

Existing production deployments keep running with whatever environment variables they were built with, but new deployments fail until you reconnect the projects to the integration on the target team.

After the transfer, reconnect each project to the integration on the target team to restore environment variables and resource access.

Transfer the integration

  1. From your Vercel dashboard, select the source team in the team switcher.
  2. Open Integrations in the sidebar.
  3. Next to the integration you want to transfer, select Manage.
  4. Open Settings in the side navigation and scroll to the Transfer Integration section.
  5. Select Transfer Integration.
  6. In the dialog, choose the target team and select Continue.
  7. If the dialog asks you to select a payment method, pick one on the target team and select Continue. Vercel uses this payment method for future charges on the transferred installation. Free or unbilled integrations skip this step.
  8. To confirm, type the integration slug shown in the dialog, then type transfer my integration. Select Continue.
  9. Wait for the transfer to complete. Vercel sends you back to the source team's Integrations list. Switch to the target team to see the moved installation.

What does not move

Item What happens
Source-team project connections The transfer is blocked while any project is still connected to a resource owned by this integration. After you disconnect every project and the transfer completes, no project connections remain. Reconnect your projects on the target team to continue using the resources
Source-team payment method Stays on the source team. Vercel does not copy it to the target team
OpenTelemetry endpoints the integration provisioned Vercel deletes them. The integration provider can recreate them on the target team
Historical usage data Stays with the source team for billing reconciliation
Existing administrators on the integration Reset to a single owner on the target team