Bubble

Connect FlowRunner to a Bubble app Data API and Workflow API using a bearer API token. Read, search, create, modify, replace, delete, and bulk-import database records, and trigger backend workflows against the Live or Development branch.

8 actions available

New data arrives that a Bubble data type should reflect

Agent searches the matching things with List / Search Things

Agent confirms the fields it will write against the data type's field names

Agent classifies whether the write is a routine sync or a change live users will see

Agent applies the routine write with Modify Thing

Agent posts the change to the operations channel

A write on the Live branch that alters what users experience waits for a person to confirm

What This Integration Enables

FlowRunner agents use Bubble to keep an app's database and its backend logic in step with the systems around it. On the Data API an agent can get a thing by ID, run List / Search Things with constraint objects to fetch a filtered and sorted result set, create a thing, modify a thing partially, replace a thing fully, delete a thing, and bulk create many things in one call. On the Workflow API it can trigger a backend workflow by endpoint name and pass parameters. The connector targets the Live or Development branch you select, so testing against version-test before touching production is a setting, not a rewrite. What it does not do is push every production write through unchecked. When a Live-branch write changes what users will see, the agent runs what is routine and asks a person before the rest.

Without FlowRunner

Copied between systems by hand Someone re-keys external records into Bubble to keep the app current

Search built one query at a time Filtered lookups are run manually in the editor, not composed in a flow

Live and test writes treated the same A change to production runs on the same path as a harmless test-branch write

With FlowRunner

Records synced in the workflow The agent searches and writes matching things automatically

Constraints composed in the flow List / Search Things fetches filtered, sorted, paginated results as a step

Production writes confirmed A change on the Live branch that users will see waits for a human first

Use Case Scenarios

Sync Records Into Bubble

New data arrives from a CRM, a spreadsheet, or an upstream feed. The agent runs List / Search Things with a constraint to find the matching thing, then applies the change with Modify Thing, or creates it with Create Thing when none exists. For a larger import, Bulk Create Things brings many records in one pass. The Bubble app stays current without anyone copying data across systems.

Search-Driven Reporting

On a schedule, the agent runs List / Search Things with equals, greater than, and date constraints to pull exactly the things a report needs, pages through the result set using the returned cursor, and feeds the values into a spreadsheet or a summary. Nothing in the Bubble database changes. The app's data drives reporting while remaining the state the app itself renders.

Confirmed Production Change

An agent is about to run a write on the Live branch that users will immediately experience, such as replacing a thing that clears fields a screen depends on, deleting a record, or triggering a backend workflow that charges or provisions something. Searching the data and preparing the write happens automatically. The write itself does not. The agent holds it for a person to confirm, then runs the action once the confirmation comes back.

Human-in-Loop Highlight

When a workflow reaches a write on the Live branch that changes what Bubble app users will experience, such as deleting a thing, replacing a thing in a way that clears fields, or triggering a backend workflow that provisions or charges, the agent does not run it on its own. It pauses and routes to the responsible person through their preferred channel: "The workflow wants to run [action] on the [data type] type on the Live branch, which users will experience as [effect]. Current values: [fields]. Confirm, or hold?" The person confirms, and only then does the agent run the action. Reads, searches, and Development-branch work keep running automatically; the production writes that reach users get a human first.

Agent processes routinely

Detects exception requiring judgment

Clear match Continues automatically

Ambiguous Routes to human via preferred channel

Human decides

Agent resumes with decision

Agent Capabilities

8 actions

Data

Get Thing Retrieves a single thing by its unique ID from a Bubble data type. Used to load the exact record a workflow needs before acting on it.
List / Search Things Retrieves a paginated list of things, optionally filtered by a JSON array of constraint objects and sorted. Supports constraint types including equals, greater than, text contains, in, and geographic_search. Used to fetch exactly the records a report or a sync step needs.
Create Thing Creates a new thing from a fields object and returns the new ID. Used to add a record when none exists yet.
Modify Thing Partially updates an existing thing; only the fields you supply change. Used to keep a thing aligned with a source system without disturbing its other fields.
Replace Thing Fully replaces an existing thing, resetting any field not included in the fields object. Used when the entire record should be overwritten, and one of the writes worth a human confirmation on the Live branch.
Delete Thing Permanently deletes a thing by its ID; this cannot be undone. Used to remove a record, and a write worth a human confirmation because live users may depend on it.
Bulk Create Things Creates many things in a single call from an array of objects and returns a per-item result list. Used to import a dataset efficiently in one pass.

Workflow

Trigger Workflow Runs a Bubble backend API workflow by endpoint name and passes a parameters object. Used to fire app-side logic from a flow, and worth a human confirmation when the workflow provisions, charges, or changes production state.

Start building with Bubble

$100 in credits. No card required. Connect in minutes.

Start Building Free Talk to us