Skip to main content
Bubble logo
  • Category: app builder
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 15
  • Triggers: 0
  • Slug: BUBBLE
  • Version: 20261101_00

Tools

Slug: BUBBLE_DATA_BULK_CREATE_THINGSBulk 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

array
required
List of objects to create. Must contain between 1 and 1000 items.
string
required
Bubble data type API name (lowercase, no spaces).
string
Bubble app subdomain to target *.bubbleapps.io (e.g., ‘my-bubble-app’).
string
Custom domain host (e.g., ‘myapp.example.com’).
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BUBBLE_DATA_CREATE_THINGTool to create a new Thing. Use when providing a complete JSON payload to add a new record.

Input Parameters

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).
string
required
Name of the data type (Thing) to create (case-sensitive).
string
Bubble app subdomain to target *.bubbleapps.io (e.g., ‘my-bubble-app’).
string
Custom domain host (e.g., ‘myapp.example.com’).
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BUBBLE_DATA_DELETE_THING_BY_IDTool 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

string
required
Unique identifier of the record to delete
string
required
Bubble data type name (must be lowercase, no spaces)
string
Bubble app subdomain to target *.bubbleapps.io (e.g., ‘my-bubble-app’).
string
Custom domain host (e.g., ‘myapp.example.com’).
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BUBBLE_DATA_GET_THING_BY_IDRetrieve 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

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’.
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.
string
Bubble app subdomain to target *.bubbleapps.io (e.g., ‘my-bubble-app’).
string
Custom domain host (e.g., ‘myapp.example.com’).
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BUBBLE_DATA_PATCH_THING_BY_IDTool to modify selected fields on a Thing by its unique ID. Use after confirming the Thing exists.

Input Parameters

string
required
Unique ID of the record to modify.
string
required
Data type name in URL format (lowercase, no spaces).
string
Bubble app subdomain to target *.bubbleapps.io (e.g., ‘my-bubble-app’).
string
Custom domain host (e.g., ‘myapp.example.com’).
object
required
JSON object of fields to update. Each key is an existing field name; each value must match the field’s type.
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BUBBLE_DATA_PUT_REPLACE_THING_BY_IDReplace all editable fields on a Bubble Thing by its unique ID. Omitted fields are left empty or reset to their configured defaults.

Input Parameters

string
required
Unique ID of the Thing to overwrite.
object
required
Mapping of each editable field name to its new value. Omitted editable fields will be reset to their default values.
string
required
Bubble data type name to target for replacement.
string
Bubble app subdomain to target *.bubbleapps.io (e.g., ‘my-bubble-app’).
string
Custom domain host (e.g., ‘myapp.example.com’).
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BUBBLE_FILE_DOWNLOADTool to download a file given its URL. Use when you need to retrieve file content for subsequent upload tests.

Input Parameters

string
required
HTTP or HTTPS URL of the file to download.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BUBBLE_FILE_TEMP_CREATEUpload base64-encoded or plain-text content as a temporary file and return its storage key, name, and MIME type.

Input Parameters

string
required
Name to assign to the temporary file (including extension)
string
required
Base64-encoded file contents or plain text data
string
required
MIME type of the file
string
Bubble app subdomain to target *.bubbleapps.io (e.g., ‘my-bubble-app’).
string
Custom domain host (e.g., ‘myapp.example.com’).
string
Full URL override for the temp upload endpoint. If provided, the request will be sent to this URL as-is.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BUBBLE_FILE_UPLOADUpload 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

object
required
File to upload.
string
Bubble subdomain (e.g., ‘my-app’) to target https://<subdomain>.bubbleapps.io/fileupload
string
Custom domain host (e.g., ‘app.example.com’) to target https://<host>/fileupload
object
Optional additional multipart form fields to include in the upload request.
string
Full URL override for the upload endpoint (e.g., https://httpbin.org/post)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BUBBLE_META_GET_SWAGGER_JSONTool 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

string
Bubble app subdomain (e.g., ‘my-bubble-app’) to target *.bubbleapps.io.
string
Full URL to the Swagger 2.0 JSON to fetch. Takes precedence if provided.
string
Custom domain host to target (e.g., ‘myapp.example.com’).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BUBBLE_O_AUTH_ACCESS_TOKENTool 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

string
Authorization code returned from /oauth/authorize; required for initial exchange.
string
required
OAuth client identifier.
string
Bubble app subdomain (e.g., ‘my-bubble-app’).
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.
string
required
Redirect URI used during the authorization request.
string
required
OAuth client secret.
string
Custom domain host (e.g., ‘myapp.example.com’).
string
Previously issued refresh token; required when grant_type=‘refresh_code’.
boolean
Whether to target the ‘/version-test’ environment when building the URL.
string
Full URL to the token endpoint. If provided, takes precedence over domain/subdomain/metadata-derived URL.
object
Additional fields to include in the POST JSON body.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BUBBLE_OAUTH_AUTHORIZEInitiate 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

string
Space-delimited list of scopes being requested.
string
Opaque value to maintain state between the request and callback (CSRF token, etc).
string
required
OAuth client identifier issued by Bubble when you register your application.
string
Bubble app subdomain (e.g., ‘my-bubble-app’) to target *.bubbleapps.io.
object
Additional query parameters to include in the authorize request.
string
required
Callback URL where Bubble will send the authorization code.
string
Custom domain host to target (e.g., ‘myapp.example.com’).
string
OAuth response type. For authorization code flow this should be ‘code’.
boolean
If True, use ‘/version-test’ in the root path for Bubble apps.
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BUBBLE_O_AUTH_REGISTER_APPSend 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

string
required
OAuth client identifier as configured in Bubble editor.
string
Bubble app subdomain (e.g., ‘my-bubble-app’).
object
Additional query parameters to append to the authorize request.
string
required
Redirect URI configured in the Bubble OAuth app.
string
OAuth client secret as configured in Bubble editor.
string
Custom domain host (e.g., ‘myapp.example.com’).
boolean
Whether to target the ‘/version-test’ environment.
string
Full URL to call instead of constructing from domain/subdomain. Useful for testing.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BUBBLE_WORKFLOW_TRIGGER_GETTrigger 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

string ("live" | "version-test")
Bubble deployment branch to target. Use ‘live’ for production workflows or ‘version-test’ for development/testing workflows.
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}
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BUBBLE_WORKFLOW_TRIGGER_POSTTriggers 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

string ("live" | "version-test")
Deployment branch to target. Use ‘live’ for production environment or ‘version-test’ for development/testing environment.
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.
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not