Documentation for Bubble credentials. Use these credentials to authenticate Bubble in n8n, a workflow automation platform.

Bubble credentials

You can use these credentials to authenticate the following nodes:

API access

You need a paid plan to access the Bubble APIs.

Supported authentication methods

Refer to Bubble's API documentation for more information about the service.

To configure this credential, you'll need a paid Bubble account and:

To set it up, you'll need to create an app:

Go to the Apps page in Bubble.
Select Create an app.
Enter a Name for your app, like n8n-integration.
Select Get started. The app's details open.
In the left navigation, select Settings (the gear cog icon).
Select the API tab.
In the Public API Endpoints section, check the box to Enable Data API.
The page displays the Data API root URL, for example: https://n8n-integration.bubbleapps.io/version-test/api/1.1/obj.
Copy the part of the URL after https:// and before .bubbleapps.io and enter it in n8n as the App Name. In the above example, you'd enter n8n-integration.
Select Generate a new API token.
Enter an API Token Label, like n8n integration.
Copy the Private key and enter it as the API Token in your n8n credential.
- Refer to Data API | Authentication for more information on generating API tokens.
In n8n, select the Environment that best matches your app:
- Select Development for an app that you haven't deployed, accessed at https://appname.bubbleapps.io/version-test or https://www.mydomain.com/version-test.
- Select Live for an app that you've deployed, accessed at https://appname.bubbleapps.io or https://www.mydomain.com.
In n8n, select your Hosting:
- If you haven't set up a custom domain, select Bubble Hosting.
- If you've set up a custom domain, select Self Hosted and enter your custom Domain.

Refer to Bubble's Creating and managing apps documentation for more information.

You can use these credentials to authenticate the following nodes:

API access

You need a paid plan to access the Bubble APIs.

Refer to Bubble's API documentation for more information about the service.

To configure this credential, you'll need a paid Bubble account and:

To set it up, you'll need to create an app:

Go to the Apps page in Bubble.
Select Create an app.
Enter a Name for your app, like n8n-integration.
Select Get started. The app's details open.
In the left navigation, select Settings (the gear cog icon).
Select the API tab.
In the Public API Endpoints section, check the box to Enable Data API.
The page displays the Data API root URL, for example: https://n8n-integration.bubbleapps.io/version-test/api/1.1/obj.
Copy the part of the URL after https:// and before .bubbleapps.io and enter it in n8n as the App Name. In the above example, you'd enter n8n-integration.
Select Generate a new API token.
Enter an API Token Label, like n8n integration.
Copy the Private key and enter it as the API Token in your n8n credential.
- Refer to Data API | Authentication for more information on generating API tokens.
In n8n, select the Environment that best matches your app:
- Select Development for an app that you haven't deployed, accessed at https://appname.bubbleapps.io/version-test or https://www.mydomain.com/version-test.
- Select Live for an app that you've deployed, accessed at https://appname.bubbleapps.io or https://www.mydomain.com.
In n8n, select your Hosting:
- If you haven't set up a custom domain, select Bubble Hosting.
- If you've set up a custom domain, select Self Hosted and enter your custom Domain.

Refer to Bubble's Creating and managing apps documentation for more information.