UI for Managing Connections

Display the list of integrations, connect and disconnect external apps, configure connections.

List Integrations

Your integration experience likely starts with a list of integrations your user can enable.

To get this list, use the following code:

const { items: integrations } = await integrationApp.integrations.find()

Integrations that already have a Connection created will have a connection property.
You can use it to indicate that the integration is already connected.

You can manage the list of available integrations on the Integrations page.

List Connections

If you want to list all the connections a user has created without listing all the available integrations, do this:

const { items: connections } = await integrationApp.connections.find()

Connect

To connect a user's account in a specific third-party app, call this method:

await integrationApp.integration('hubspot').openNewConnection()

Or if you want to create your own authentication UI, check out this guide: Custom Connection UI

Disconnect

To disconnect a specific connection, call this method:

await integrationApp.connection('hubspot').archive()

Next Steps