# Bubble AI integration on Definable

> Bubble is a visual programming language and a PaaS developed by Bubble Group.

## What this connects

Bubble is a visual programming language and a PaaS developed by Bubble Group.

Vendor: https://bubble.io/

## Tools available

**15** tools available. First 12:

- `BUBBLE_DATA_BULK_CREATE_THINGS` — Bulk Create Things — Tool to bulk create multiple Things in Bubble via newline-separated JSON. Use when you need to insert many records at once. Must have Create via API permission.
- `BUBBLE_DATA_CREATE_THING` — Create Thing — Tool to create a new Thing. Use when providing a complete JSON payload to add a new record.
- `BUBBLE_DATA_DELETE_THING_BY_ID` — Delete Thing By ID — Tool to delete a Bubble Thing by its unique ID. Use when you need to remove a specific record via the Bubble Data API.
- `BUBBLE_DATA_GET_THING_BY_ID` — Get Thing By ID — Retrieves a single Thing (record) from a Bubble Data Type by its unique ID. This is a read-only operation that fetches complete details of a specific record. The response includes all custom fields defined in the Data Type, plus standard Bubble fields (_id, created_by, created_date, modified_date). Use when you need to: - Fetch details of a specific record you know the ID of - Verify a record exists - Get the latest field values for a Thing Note: Requires the Data API to be enabled in your Bubble app settings and the specific Data Type to be exposed via the API.
- `BUBBLE_DATA_PATCH_THING_BY_ID` — Patch Thing By ID — Tool to modify selected fields on a Thing by its unique ID. Use after confirming the Thing exists.
- `BUBBLE_DATA_PUT_REPLACE_THING_BY_ID` — Replace Thing by ID — Tool to replace all editable fields on a Thing by its Unique ID. Use when you need a full overwrite of a Thing's fields and reset omitted fields to default.
- `BUBBLE_FILE_DOWNLOAD` — Download File — Tool to download a file given its URL. Use when you need to retrieve file content and obtain an s3key for subsequent upload tests.
- `BUBBLE_FILE_TEMP_CREATE` — Create Temp File — Tool to upload bytes as a temporary file to Cloudflare R2 and return an S3 key. Use when you need a short-lived file reference before persisting it in a Thing.
- `BUBBLE_FILE_UPLOAD` — Upload File — Tool to upload a file to Bubble storage. Use when you need to store arbitrary files via Bubble's /fileupload endpoint.
- `BUBBLE_META_GET_SWAGGER_JSON` — Get Bubble API Swagger JSON — Tool to retrieve the auto-generated Swagger JSON for enabled APIs. Use after enabling the Swagger file in your Bubble app's API settings.
- `BUBBLE_O_AUTH_ACCESS_TOKEN` — Get OAuth Access Token — Tool to exchange an authorization code or refresh token for an OAuth2 access token. Use after obtaining an authorization code or when refreshing an expired token.
- `BUBBLE_OAUTH_AUTHORIZE` — OAuth Authorize — Tool to initiate OAuth2 authorization flow for Bubble. Use when setting up third-party login integration. Returns the URL for user-agent redirection to obtain an authorization code.

## Auth

Auth schemes: `API_KEY`.

## How agents use Bubble

Inside a Definable workflow, Bubble is one of the tools the **Distributor specialist** can call. Example coordination patterns:

- **Researcher → Bubble** — the Researcher (GPT-5.5) pulls context from Bubble (records, threads, documents), synthesises findings, and briefs the rest of the team.
- **Writer → Distributor → Bubble** — the Writer (Claude Opus 4.7) drafts copy in brand voice, the Verifier passes it, then the Distributor writes the result into Bubble (create record, post message, draft email).
- **Designer / Engineer → Distributor → Bubble** — the Designer ships an asset or the Engineer ships a code change, the Distributor delivers it via Bubble (attach file, open PR comment, post status).

The Verifier checks every Bubble call. On rate limit, schema drift, or auth refresh it self-heals and retries — the workflow completes without manual intervention.

## Categories

- app builder — https://definable.ai/apps/category/app-builder/
- developer tools — https://definable.ai/apps/category/developer-tools/

## Related

- HTML page: https://definable.ai/apps/bubble/
- Same category (app builder): https://definable.ai/apps/category/app-builder/
- All integrations: https://definable.ai/apps/
- Workflow (multi-agent loop): https://definable.ai/workflow/
- Apps llms.txt index: https://definable.ai/llms-apps.txt