Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.refold.ai/llms.txt

Use this file to discover all available pages before exploring further.

If you are building a Custom UI for your users using the Refold SDKs and now want to build the functionality for your users to connect or disconnect with the applications that you have displayed, you can do so by using the SDKs. Sequence Diagram for Managing App Connections

​
Using Refold SDKs

​
.connect() method

The .connect() method in the JS SDK by Refold lets your customers to connect to an application platform, authorizing you to access the platform APIs and data on their behalf.
Method
cobalt.connect("slack") // opens a new tab for OAuth apps
cobalt.connect("twilio", {
  number: 1234567890,
  sid: "ACCOUNT_SID",
}) // saves the auth data for Key based apps
The .connect() method requires the application slug for which the connection needs to be made and if the app is Key-based, then it requires a Payload containing the auth data. The method will return true if the connection was successful.

​
.disconnect() method

The .disconnect() method disconnects the specified application and remove any associated data from Refold.
Method
cobalt.disconnect("slack")
The .disconnect() method requires the application slug for which the disconnection needs to be done.

​
Handle App ReAuth

Once the end customer goes through the auth flow, Refold saves the encrypted tokens and keys and refreshes them if/when required to maintain the functionality of the created workflows. However, there are certain conditions where Refold can no longer authenticate the API on behalf of your end customers.
  1. The provided API credentials for eg: API keys, Refresh token has expired.
  2. The access token or refresh token of the end customer has been revoked.
  3. The end customer uninstalls the application.
  4. The user deletes the application being used by their customer.
When any of the above conditions occur, Refold helps you handle the reauthenication for the integration.
Checkout this documentation to understand how you can handle it here.