Skip to main content

When Reauthorization is Needed

  • OAuth tokens expire
  • User revokes access
  • API keys are rotated
  • Permissions change

Detecting Auth Issues

Webhook event: integrated_account:authentication_error This event is sent when:
  • OAuth token refresh fails
  • API call returns 401 Unauthorized

Reauthorize via Dashboard

1

Open Account

Go to Integrated Accounts and select the account
2

Start Reauthorization

Click Reauthorize connection
3

Get Link

Click Get connection link
4

Complete

Complete the authorization flow

Reauthorize via API

Generate a link token for the existing account:
Use the token to open the reauthorization UI:

Embed in Your App

Use the Link SDK with the existing account ID to prompt users to reauthorize.

After Reauthorization

Webhook event: integrated_account:reactivated The account status returns to active and API calls work again.