---
title: "Bubble integration for LuumenAI"
url: "https://www.luumen.ai/integrations/bubble/"
entity: SoftwareIntegration
category: "Source control & CI/CD"
audience: "SRE, DevOps, platform engineering, IT operations"
---

# Bubble integration for LuumenAI

Read Bubble app data and API schemas, then change records as approved steps.

## What LuumenAI can do with Bubble

LuumenAI connects to Bubble with an API token and exposes 15 tools (5 read-only · 9 write · 1 destructive). Reads answer immediately; writes are shown as a plan and require approval by default, configurable per tool by an administrator.

## Key facts

- Authentication: API token
- Tools available: 15 tools (5 read-only · 9 write · 1 destructive)
- Plan: available on all plans
- Category: Source control & CI/CD

## About Bubble with LuumenAI

Connect the Bubble app your team runs on and Luumen can read it for context: pull a single Thing by ID, inspect the auto-generated Swagger for the enabled Data and Workflow APIs, download a stored file. Changes to records — creating, patching, replacing, deleting Things — are previewed and approved before they run. Authentication is by API key.

## Example tools

Read-only (5 in total):

- `BUBBLE_DATA_GET_THING_BY_ID` — Retrieves a single Thing (record) from a Bubble Data Type by its unique ID.
- `BUBBLE_FILE_DOWNLOAD` — Download a file given its URL.
- `BUBBLE_META_GET_SWAGGER_JSON` — Retrieve the auto-generated Swagger JSON for enabled APIs.
- `BUBBLE_OAUTH_AUTHORIZE` — Initiate OAuth2 authorization flow for Bubble.
- `BUBBLE_O_AUTH_REGISTER_APP` — Validate/initialize OAuth application credentials with Bubble.

Write and destructive (10 in total, approval required by default):

- `BUBBLE_DATA_BULK_CREATE_THINGS` — Bulk create multiple Things in Bubble via newline-separated JSON.
- `BUBBLE_DATA_CREATE_THING` — Create a new Thing.
- `BUBBLE_DATA_DELETE_THING_BY_ID` — Delete a Bubble Thing by its unique ID.
- `BUBBLE_DATA_PATCH_THING_BY_ID` — Modify selected fields on a Thing by its unique ID.
- `BUBBLE_DATA_PUT_REPLACE_THING_BY_ID` — Replace all editable fields on a Thing by its Unique ID.
- `BUBBLE_FILE_TEMP_CREATE` — Upload bytes as a temporary file to Cloudflare R2 and return an S3 key.
- `BUBBLE_FILE_UPLOAD` — Upload a file to Bubble storage.
- `BUBBLE_O_AUTH_ACCESS_TOKEN` — Exchange an authorization code or refresh token for an OAuth2 access token.

## Frequently asked questions

### How does LuumenAI connect to Bubble?

Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.

### Can LuumenAI change things in Bubble on its own?

Read actions answer immediately. Anything that writes is shown as a plan and requires approval by default, including the 1 action classified as destructive. Administrators configure that per tool.

### Is there an audit trail?

Every call to Bubble — read or write, approved or declined — is recorded with the actor, the input, and the result.

Full page: https://www.luumen.ai/integrations/bubble/