Reconnecting a stale integration
This document explains how to reconnect an integration whose authentication credentials are no longer valid.
Sometimes customers change integration authentication details, API keys expire, or other integration setup details are changed and Kombo can no longer authenticate with an integration that was previously connected.
After 3 consecutive days of failing authentication (during the initial authentication check of a synchronization), Kombo will pause the sync of an integration until the integration is reconnected. In this case, the customer will need to be prompted to reconnect for the integration to function again.
Methods of reconnecting
Use the dashboard to create an update link
Open up Kombo dashboard and navigate to any integration that you want to reconnect. Navigate to “Relink integration” and create an update link. You can send this to your customer to update the credentials of the integration. Once they have re-connected successfully, the sync will start running again.
Use the API to create a reconnection link
-
Using the integration details endpoint, check whether integration has a status of
INVALID
. -
Create a reconnection link with our reconnection link endpoint. Use this link in the same as during the Kombo Connect embedded flow.
-
Once the customer has updated their credentials and reconnected successfully, the sync will start running again.