Bubble

Actions

The Bubble node allows you to automate work in Bubble, and integrate Bubble with other applications. n8n has built-in support for a wide range of Bubble features, including creating, deleting, getting, and updating objects.

On this page, you'll find a list of operations the Bubble node supports and links to more resources.

Credentials

Refer to Bubble credentials for guidance on setting up authentication.

Examples the Templates

For usage examples and templates to help you get started, take a look at n8n's Bubble integrations list.

Basic Operations#

  • Object
    • Create
    • Delete
    • Get
    • Get All
    • Update

Example Usage#

This workflow allows you to create, update, and get an object from Bubble. You can also find the workflow on n8n.io. This example usage workflow would use the following nodes. - Start - Bubble

The final workflow should look like the following image.

A workflow with the Bubble node

1. Start node#

The start node exists by default when you create a new workflow.

2. Bubble node (create: object)#

This node will create a new object of the type Doc in Bubble. If you want to create an object with a different type, use that type instead.

  1. First of all, you'll have to enter credentials for the Bubble node. You can find out how to do that here.
  2. Select 'Create' from the Operation dropdown list.
  3. Enter Doc in the Type Name field.
  4. Click on the Add Property button.
  5. Enter Name in the Key field. If you're using a different type, enter the field name present in the type.
  6. Enter Bubble in the Value field.
  7. Click on Execute Node to run the node.

In the screenshot below, you will notice that the node creates a new object of the type Doc in Bubble.

Using the Bubble node to create a new object

3. Bubble1 node (update: object)#

This node will update the object that we created using the previous node.

  1. Select the credentials that you entered in the previous Bubble node.
  2. Select 'Update' from the Operation dropdown list.
  3. Click on the gears icon next to the Type Name field and click on Add Expression.
  4. Select the following in the Variable Selector section: Nodes > Bubble > Parameters > typeName. You can also add the following expression: {{$node["Bubble"].parameter["typeName"]}}.
  5. Click on the gears icon next to the Object ID field and click on Add Expression.
  6. Select the following in the Variable Selector section: Current Node > Input Data > JSON > id. You can also add the following expression: {{$json["id"]}}.
  7. Click on the Add Property button.
  8. Enter Name in the Key field. If you're using a different type, enter the field name present in the type.
  9. Enter Bubble node in the Value field.
  10. Click on Execute Node to run the node.

In the screenshot below, you will notice that the node updates the information of the object that got created previously.

Using the Bubble node to update the information of an object

4. Bubble2 node (get: object)#

This node will retrieve the information of the object that we created earlier.

  1. Select the credentials that you entered in the previous Bubble node.
  2. Click on the gears icon next to the Type Name field and click on Add Expression.
  3. Select the following in the Variable Selector section: Nodes > Bubble > Parameters > typeName. You can also add the following expression: {{$node["Bubble"].parameter["typeName"]}}.
  4. Click on the gears icon next to the Object ID field and click on Add Expression.
  5. Select the following in the Variable Selector section: Nodes > Bubble > Output Data > JSON > id. You can also add the following expression: {{$node["Bubble"].json["id"]}}.
  6. Click on Execute Node to run the node.

In the screenshot below, you will notice that the node retrieves the information of the object that we created earlier.

Using the Bubble node to retrieve the information of an object

 
 

Credentials

You can use these credentials to authenticate the following nodes with Bubble.

Prerequisites#

Create a Bubble account.

Note: You need a Personal or a higher plan to get access to the Bubble API.

Using API Key#

  1. Open your Bubble dashboard page.
  2. Select an app under the My apps section to open the app.
  3. Click on Settings on the left-sidebar.
  4. Click on the API tab.
  5. Click on the Generate a new API token button.
  6. Enter a token name in the API Token Label field.
  7. Copy the displayed Private Key.
  8. Enter the name for your credentials in the Credentials Name field in the 'Bubble API' credentials in n8n.
  9. Paste the Private Key in the API Token field in the 'Bubble API' credentials in n8n.
  10. Enter the app name in the APP Name field.
  11. Select 'Development' from the Environment dropdown list. If you want to use the 'Live' environment, select 'Live' instead.
  12. Click on the Create button to create your credentials.

Note: If you're self-hosting your Bubble app, select 'Self-hosted' from the Hostingdropdown list. You will also need to enter the domain of your hosted instance in the Domain field.