Reauthorizing Connections in an Integrated Account

Sometimes, you may need to refresh your connection to an integration in Truto. This could be because of changes to your integration settings or updates in the integration itself. Reauthorizing your connection will allow the integration to continue to work properly with the updated information.

Getting notified about reauthorization

In case of OAuth integrations, when an end-user revokes access for the OAuth app, Truto will not be able to refresh the access tokens. In such cases, Truto will send an integrated_account:authentication_error which will contain the integrated account as the payload. You can use this event to notify the end-user about the issue and ask them to re-authorize the connection.

Webhooks Guide

The integrated_account:authentication_error event will be sent when there is an issue with refreshing the access token for an integrated account regardless of what the underlying issue is.

Reauthorize Connections via Truto interface

Follow these simple steps:

1. Sign into Truto and go to the Integrated Accounts section or click here.
2. Select an Integrated Account. In the account details, you will find an option labeled 'Connection'.
3. Click on 'Reauthorize connection'. A new window will open.
4. Click on 'Get connection link' and then on the 'Magic Link' for re-authorization. Alternatively, you can share this magic link with your customer to allow them to connect their account.

What happens next?

After clicking on the Magic Link, you will be redirected to your account on the integrated platform. You will have to log in and allow access to Truto. Follow the steps for authentication, and upon successful completion, you will see a 'Connection successful' message. You can then close the tab.

Reauthorizing an account via API

Use the following cURL command to generate a link-token. Truto uses Bearer authorization, replace the <your-api-token> in the command below with your API token.

Create Link Token API Reference

curl --location 'https://api.truto.one/link-token' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <your-api-token>' \
--data '{
    "integrated_account_id": "<integrated-account-id>"
}'

Response:

{
    "link_token": "e73c7b9b-2e4d-47d1-b5d2-83441fd24e4c"
}

Use the following URL, to launch Truto's connection UI. Remember to replace <link-token-from-previous-step> with the actual link token received from the API request.

https://app.truto.one/connect-account?link_token=<link-token-from-previous-step>

Embedding the linking flow within your app

You can also use our Frontend Link SDK to embed the connection flow within your UI. More details here.

With this, your Re-authorization process is complete! You've now ensured that your Truto integration will continue to work properly, even with the updated information.