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: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.
