> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Bubble

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

![Bubble logo](https://mintcdn.com/composio-preview/PudKL42NVsy5O-ND/images/toolkits/bubble.svg?fit=max\&auto=format\&n=PudKL42NVsy5O-ND\&q=85\&s=2cb7a272a88d5bdeed9395deb3914d29)

* **Category:** app builder
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 15
* **Triggers:** 0
* **Slug:** `BUBBLE`
* **Version:** 20261101\_00

## Tools

> [accordion] Bulk Create Things
>
> **Slug:** `BUBBLE_DATA_BULK_CREATE_THINGS`
>
> Bulk create up to 1,000 Bubble Things via newline-separated JSON, with Create via API permission. Creation can partially succeed, so check the per-item results.
>
> #### Input Parameters
>
> **items** `array` *required*
>
> List of objects to create. Must contain between 1 and 1000 items.
>
> **typename** `string` *required*
>
> Bubble data type API name (lowercase, no spaces).
>
> **subdomain** `string`
>
> Bubble app subdomain to target \*.bubbleapps.io (e.g., 'my-bubble-app').
>
> **custom\_domain** `string`
>
> Custom domain host (e.g., 'myapp.example.com').
>
> **full\_url\_override** `string`
>
> Full URL override for the bulk endpoint. If provided, the request will be sent to this URL as-is, ignoring 'typename', 'custom\_domain', and 'subdomain'.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Thing
>
> **Slug:** `BUBBLE_DATA_CREATE_THING`
>
> Tool to create a new Thing. Use when providing a complete JSON payload to add a new record.
>
> #### Input Parameters
>
> **fields** `object` *required*
>
> JSON object mapping field names to values for the new Thing. Required fields must be provided (e.g., 'email' for the User type).
>
> **typename** `string` *required*
>
> Name of the data type (Thing) to create (case-sensitive).
>
> **subdomain** `string`
>
> Bubble app subdomain to target \*.bubbleapps.io (e.g., 'my-bubble-app').
>
> **custom\_domain** `string`
>
> Custom domain host (e.g., 'myapp.example.com').
>
> **full\_url\_override** `string`
>
> Full URL override for the create endpoint. If provided, the request will be sent to this URL as-is, ignoring 'typename', 'custom\_domain', and 'subdomain'.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Thing By ID
>
> **Slug:** `BUBBLE_DATA_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.
>
> #### Input Parameters
>
> **uid** `string` *required*
>
> Unique identifier of the record to delete
>
> **typename** `string` *required*
>
> Bubble data type name (must be lowercase, no spaces)
>
> **subdomain** `string`
>
> Bubble app subdomain to target \*.bubbleapps.io (e.g., 'my-bubble-app').
>
> **custom\_domain** `string`
>
> Custom domain host (e.g., 'myapp.example.com').
>
> **full\_url\_override** `string`
>
> Full URL override for the delete endpoint. If provided, the request will be sent to this URL as-is, ignoring 'typename', 'custom\_domain', and 'subdomain'.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Thing By ID
>
> **Slug:** `BUBBLE_DATA_GET_THING_BY_ID`
>
> Retrieve a Bubble Thing by data type and unique ID. Returned fields depend on the app's privacy rules and the client's access; the Data API must be enabled and the data type exposed.
>
> #### Input Parameters
>
> **uid** `string` *required*
>
> The unique identifier of the Thing to retrieve. This is the value returned in the '\_id' or 'id' field when the Thing was created. Bubble typically uses format like '1234567890123x123456789012345678'.
>
> **typename** `string` *required*
>
> The Bubble Data Type name (case-sensitive). This is the custom data type defined in your Bubble app (e.g., 'user', 'order', 'product'). Check your Bubble app's Data tab for available types.
>
> **subdomain** `string`
>
> Bubble app subdomain to target \*.bubbleapps.io (e.g., 'my-bubble-app').
>
> **custom\_domain** `string`
>
> Custom domain host (e.g., 'myapp.example.com').
>
> **full\_url\_override** `string`
>
> Full URL override for the GET endpoint. If provided, the request will be sent to this URL as-is, ignoring 'typename', 'custom\_domain', and 'subdomain'.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Patch Thing By ID
>
> **Slug:** `BUBBLE_DATA_PATCH_THING_BY_ID`
>
> Tool to modify selected fields on a Thing by its unique ID. Use after confirming the Thing exists.
>
> #### Input Parameters
>
> **uid** `string` *required*
>
> Unique ID of the record to modify.
>
> **typename** `string` *required*
>
> Data type name in URL format (lowercase, no spaces).
>
> **subdomain** `string`
>
> Bubble app subdomain to target \*.bubbleapps.io (e.g., 'my-bubble-app').
>
> **custom\_domain** `string`
>
> Custom domain host (e.g., 'myapp.example.com').
>
> **field\_updates** `object` *required*
>
> JSON object of fields to update. Each key is an existing field name; each value must match the field’s type.
>
> **full\_url\_override** `string`
>
> Full URL override for the patch endpoint. If provided, the request will be sent to this URL as-is, ignoring 'typename', 'custom\_domain', and 'subdomain'.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Replace Thing by ID
>
> **Slug:** `BUBBLE_DATA_PUT_REPLACE_THING_BY_ID`
>
> Replace all editable fields on a Bubble Thing by its unique ID. Omitted fields are left empty or reset to their configured defaults.
>
> #### Input Parameters
>
> **uid** `string` *required*
>
> Unique ID of the Thing to overwrite.
>
> **data** `object` *required*
>
> Mapping of each editable field name to its new value. Omitted editable fields will be reset to their default values.
>
> **typename** `string` *required*
>
> Bubble data type name to target for replacement.
>
> **subdomain** `string`
>
> Bubble app subdomain to target \*.bubbleapps.io (e.g., 'my-bubble-app').
>
> **custom\_domain** `string`
>
> Custom domain host (e.g., 'myapp.example.com').
>
> **full\_url\_override** `string`
>
> Full URL override for the PUT endpoint. If provided, the request will be sent to this URL as-is, ignoring 'typename', 'custom\_domain', and 'subdomain'.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Download File
>
> **Slug:** `BUBBLE_FILE_DOWNLOAD`
>
> Tool to download a file given its URL. Use when you need to retrieve file content for subsequent upload tests.
>
> #### Input Parameters
>
> **url** `string` *required*
>
> HTTP or HTTPS URL of the file to download.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Temp File
>
> **Slug:** `BUBBLE_FILE_TEMP_CREATE`
>
> Upload base64-encoded or plain-text content as a temporary file and return its storage key, name, and MIME type.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Name to assign to the temporary file (including extension)
>
> **content** `string` *required*
>
> Base64-encoded file contents or plain text data
>
> **mimetype** `string` *required*
>
> MIME type of the file
>
> **subdomain** `string`
>
> Bubble app subdomain to target \*.bubbleapps.io (e.g., 'my-bubble-app').
>
> **custom\_domain** `string`
>
> Custom domain host (e.g., 'myapp.example.com').
>
> **full\_url\_override** `string`
>
> Full URL override for the temp upload endpoint. If provided, the request will be sent to this URL as-is.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Upload File
>
> **Slug:** `BUBBLE_FILE_UPLOAD`
>
> Upload a file to a Bubble app's storage. The upload can target the connected app, a custom domain or subdomain, or a specified upload URL, and can include additional form fields.
>
> #### Input Parameters
>
> **file** `object` *required*
>
> File to upload.
>
> **subdomain** `string`
>
> Bubble subdomain (e.g., 'my-app') to target https\://\<subdomain>.bubbleapps.io/fileupload
>
> **custom\_domain** `string`
>
> Custom domain host (e.g., 'app.example.com') to target https\://\<host>/fileupload
>
> **additional\_fields** `object`
>
> Optional additional multipart form fields to include in the upload request.
>
> **full\_url\_override** `string`
>
> Full URL override for the upload endpoint (e.g., [https://httpbin.org/post](https://httpbin.org/post))
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Bubble API Swagger JSON
>
> **Slug:** `BUBBLE_META_GET_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.
>
> #### Input Parameters
>
> **subdomain** `string`
>
> Bubble app subdomain (e.g., 'my-bubble-app') to target \*.bubbleapps.io.
>
> **swagger\_url** `string`
>
> Full URL to the Swagger 2.0 JSON to fetch. Takes precedence if provided.
>
> **custom\_domain** `string`
>
> Custom domain host to target (e.g., 'myapp.example.com').
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get OAuth Access Token
>
> **Slug:** `BUBBLE_O_AUTH_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.
>
> #### Input Parameters
>
> **code** `string`
>
> Authorization code returned from /oauth/authorize; required for initial exchange.
>
> **client\_id** `string` *required*
>
> OAuth client identifier.
>
> **subdomain** `string`
>
> Bubble app subdomain (e.g., 'my-bubble-app').
>
> **grant\_type** `string`
>
> Must be 'refresh\_code' when exchanging a refresh token for a new access token. Note: Bubble uses 'refresh\_code' instead of the standard OAuth 2.0 'refresh\_token' value.
>
> **redirect\_uri** `string` *required*
>
> Redirect URI used during the authorization request.
>
> **client\_secret** `string` *required*
>
> OAuth client secret.
>
> **custom\_domain** `string`
>
> Custom domain host (e.g., 'myapp.example.com').
>
> **refresh\_token** `string`
>
> Previously issued refresh token; required when grant\_type='refresh\_code'.
>
> **use\_version\_test** `boolean`
>
> Whether to target the '/version-test' environment when building the URL.
>
> **token\_url\_override** `string`
>
> Full URL to the token endpoint. If provided, takes precedence over domain/subdomain/metadata-derived URL.
>
> **additional\_body\_fields** `object`
>
> Additional fields to include in the POST JSON body.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] OAuth Authorize
>
> **Slug:** `BUBBLE_OAUTH_AUTHORIZE`
>
> Initiate OAuth authorization with a GET request and return the redirect location, or the request URL if no redirect is supplied. An authorization endpoint URL can be supplied explicitly.
>
> #### Input Parameters
>
> **scope** `string`
>
> Space-delimited list of scopes being requested.
>
> **state** `string`
>
> Opaque value to maintain state between the request and callback (CSRF token, etc).
>
> **client\_id** `string` *required*
>
> OAuth client identifier issued by Bubble when you register your application.
>
> **subdomain** `string`
>
> Bubble app subdomain (e.g., 'my-bubble-app') to target \*.bubbleapps.io.
>
> **extra\_params** `object`
>
> Additional query parameters to include in the authorize request.
>
> **redirect\_uri** `string` *required*
>
> Callback URL where Bubble will send the authorization code.
>
> **custom\_domain** `string`
>
> Custom domain host to target (e.g., 'myapp.example.com').
>
> **response\_type** `string`
>
> OAuth response type. For authorization code flow this should be 'code'.
>
> **use\_version\_test** `boolean`
>
> If True, use '/version-test' in the root path for Bubble apps.
>
> **authorize\_url\_override** `string`
>
> Full URL to the authorization endpoint. If provided, takes precedence over subdomain/custom\_domain/metadata-derived URL. Useful for testing against non-Bubble endpoints (e.g., httpbin) or when metadata contains placeholders.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Bubble OAuth Register App
>
> **Slug:** `BUBBLE_O_AUTH_REGISTER_APP`
>
> Send an OAuth authorization request using the supplied client ID and redirect URI, and return the supplied credentials, HTTP status and any redirect location.
>
> #### Input Parameters
>
> **client\_id** `string` *required*
>
> OAuth client identifier as configured in Bubble editor.
>
> **subdomain** `string`
>
> Bubble app subdomain (e.g., 'my-bubble-app').
>
> **extra\_params** `object`
>
> Additional query parameters to append to the authorize request.
>
> **redirect\_uri** `string` *required*
>
> Redirect URI configured in the Bubble OAuth app.
>
> **client\_secret** `string`
>
> OAuth client secret as configured in Bubble editor.
>
> **custom\_domain** `string`
>
> Custom domain host (e.g., 'myapp.example.com').
>
> **use\_version\_test** `boolean`
>
> Whether to target the '/version-test' environment.
>
> **authorize\_url\_override** `string`
>
> Full URL to call instead of constructing from domain/subdomain. Useful for testing.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Trigger Bubble Workflow via GET
>
> **Slug:** `BUBBLE_WORKFLOW_TRIGGER_GET`
>
> Trigger a Bubble API workflow using an HTTP GET request. API workflows are server-side workflows in Bubble that can be triggered externally. Use GET for simple workflows that don't require a request body (parameters passed as query strings). For workflows requiring complex data or file uploads, use the POST version instead. Before using: The workflow must be created in Bubble's workflow editor and marked as "Expose as a public API workflow". The Bubble app must have API access enabled in its subscription.
>
> #### Input Parameters
>
> **branch** `string ("live" | "version-test")`
>
> Bubble deployment branch to target. Use 'live' for production workflows or 'version-test' for development/testing workflows.
>
> **parameters** `object`
>
> Query string parameters to pass to the workflow, matching the workflow's defined inputs. Each key should match a parameter name configured in your Bubble workflow. Values can be strings, numbers, booleans, or simple objects. Example: \{'user\_id': '123', 'send\_email': true, 'priority': 1}
>
> **workflow\_name** `string` *required*
>
> Name of the API workflow to trigger (as defined in Bubble's workflow editor). This is the exact name you gave the workflow, which becomes part of the endpoint URL. Example: if your workflow is named 'send\_email', use 'send\_email'.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Trigger Bubble Workflow via POST
>
> **Slug:** `BUBBLE_WORKFLOW_TRIGGER_POST`
>
> Triggers a Bubble API workflow by name using a POST request. Use this tool to execute backend workflows in your Bubble application. The workflow must be configured in your Bubble app's API Workflows section with "Expose as public API workflow" enabled. Pass any required parameters as a JSON object in the parameters field.
>
> #### Input Parameters
>
> **branch** `string ("live" | "version-test")`
>
> Deployment branch to target. Use 'live' for production environment or 'version-test' for development/testing environment.
>
> **parameters** `object`
>
> JSON body parameters to pass to the workflow, matching the workflow's configured input parameters. Use ISO 8601 format for dates (e.g., '2024-01-15T10:30:00Z'), and unique IDs (strings) for Bubble data type references.
>
> **workflow\_name** `string` *required*
>
> URL-friendly name of the Bubble API workflow to trigger. This is the name you configured in your Bubble app's API Workflows section, converted to lowercase with hyphens instead of spaces (e.g., 'send-email', 'process-payment').
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
