Bubble App Connector

The App Connector connects two Bubble apps and accesses the API and data of one app in another. By doing so, you can sign up with OAuth with another app, run workflows as the user, etc.

To make this work, set up an API with the first app A before using it in app B. To enable users to sign up with app A in app B, define some OAuth credentials in app A. Once this is done, install the Bubble App Connector and add app A in app B.

Once you've added an app and installed some calls, you can use them either as a data source in 'Get data from API' or as actions in workflows.

App domain

Enter the domain of the app. It should be similar to https://appdomain.com or https://appname.bubbleapps.io, i.e., without a page. Using this domain, Bubble will automatically fetch the metadata of the app.

Note: Be sure to use the bare domain (no 'www'), as including the 'www' can lead to unexpected behavior when using the App Connector in workflows.

Match versions (Live vs Dev.)

Check this box when you want the test version of app A to interact with the test version of app B. Typically, this box is checked.

App name

This is how to describe the app within the Bubble Editor. By default, this is the app name, but it can be renamed. This is important when referring to the different calls in the Bubble Editor.

Private key

Enter the Private key generated in the API section in the Settings Tab of the app you want to connect with.

Client ID

Enter the Client ID of the app for OAuth purposes.

Client secret

Enter the Client secret of the app for OAuth purposes.

Call name

Select the call to install. It can either be an API Workflow or GET call.

Call type

Select whether to use the call as a data source or action. Normally, API Workflows will be actions, and GET calls will be data sources, but in some cases it may be different. For example, when an API Workflow returns data.


Select which type of authentication you want to call to run. If you select Private key, it will run as an admin in the second app. If you select OAuth and enter a Client ID and Client secret, calls will run as the current user after signing up with OAuth. In this case, privacy rules, etc. will apply as the user. No authentication will run calls without any credentials.

Refresh app metadata

To modify both apps at the same time, click this button to refresh the data.

Things to note

Known Issue

When using the API Connector or App Connector, parameters currently cannot be a 'raw' list of Bubble Things, e.g. a dynamic statement that results in a List of Things. This is because a raw list of Bubble Things is not rendered in the kind of text formatting that API endpoints expect. One workaround for this is to use the ":join with" operator on the list of Bubble Things to turn it into a format accepted by the API endpoint (this is likely a format like ["first thing", "second thing"]).