Bubble

Save an uninitialized API Connector call definition; this does not send the request. Initialize it in the editor's API Connector tab (its own left-nav tab, not the Plugins tab) to detect response fields before using its response; until then it cannot be used as a workflow action or data source. Private headers and parameters are stored securely; use REPLACE_ME for values to fill later. The created call id is in appliedChanges[0].args.call_id.

create_api_call

Create an API Connector collection and install the API Connector plugin if needed. Auth keys and passwords are never taken here; the user enters them in the editor's API Connector tab. Private header and parameter values are stored securely and redacted in the response. The CreateApiCollection change's args.id is the collection id.

create_api_collection

Create a workflow action, last by default or after another action. Choose its type and fields from list_action_types. Expressions may reference earlier actions in the same event by id. The created action id is in appliedChanges[0].args.id. ObjectList fields are written as literals: NewThing `initial_values` and ChangeThing `changes` are {0: {key: <field key such as name_text>, value: <expression>}, 1: ...}, and a list field also needs action: "set_list" | "add_list" | "remove_list". APIEvent `parameters` is {<key>: {key, value: <type id>, optional, is_list, in_url}} with the object key equal to `key`; CurrentWorkflowItem then takes that key as param_id.

create_action

Create a private Bubble app on the free plan, owned by the authenticated caller. Check the name with check_app_name first. Returns appname, editorUrl, and previewUrl. At least one of webApp or mobileApp must be enabled. App creation is subject to the caller's creation limit.

create_app

Create a development branch from an existing non-live app version. Returns the new branch metadata; pass its name as appVersion in subsequent tools to work on that branch. The app's plan and version-control permissions must allow branch creation.

create_branch

Create a color variable in the Style variables tab. Its id is in appliedChanges[0].args.target_id; reference it in properties as var(--color_<id>_default).

create_color_token

Append a conditional to an element. Its yes/no expression controls the supplied property overrides; properties marked noStates cannot be conditional. The new zero-based index is in appliedChanges[0].args.rank. Later conditionals win when several hold.

create_conditional

Create a custom state on an element, page, or reusable definition. Use a type id from list_types. The server-derived state key is in appliedChanges[0].args.name.

create_custom_state

Create a data type with optional fields. The type key is in appliedChanges[0].args.name; subsequent WriteCustomField changes contain field keys in args.name. Use those field keys in expressions and initial_values. Add self-referencing fields afterward with create_field. Starting privacy follows the app's new-type defaults.

create_data_type

Create an element under a page, mobile view, reusable, or container using the Design palette's defaults. Get types from list_element_types and property names from get_element_type_fields. Its default catalog omits styling fields; request sections: ["appearance"] for styling or ["all"] before treating a missing field as unsupported. Initial properties are static; use set_element_properties for expressions. The created id is in appliedChanges[0].args.id. Build ordinary page structure with containers whose container_layout is "row" or "column" so it responds to available width. Use "fixed" or "relative" (Align to parent) container layouts only for intentional absolute positioning such as overlays. In row and column containers, prefer responsive size modes: groups and text should generally fill available width, while text and other content-driven elements should fit height to content. In those containers, reserve fixed dimensions for intentionally invariant elements such as icons. Omitting width or height there does not make an element responsive because the palette default may still be Fixed; set the size mode fields from get_element_type_fields explicitly. A RepeatingGroup starts with fixed_rows true, as in the palette, so it shows only its first `rows` rows (4 by default); pass properties: { fixed_rows: false } to show the whole list and grow as data is added. Build visible UI from native elements. Use an HTML element only for an effect no native element or field provides (check get_element_type_fields with sections: ["all"]), such as a CSS blur on a Group: keep the HTML element free of visible content, give the target element a static unique_id, and scope the CSS to that id. unique_id renders only in run mode when the app setting "Expose the option to add an ID attribute to HTML elements" is on; tell the user.

create_element

Create a workflow event on a page, mobile view, reusable, or the api backend root. Choose a type and its fields from list_event_types. Element-scoped events require elementId. The created event id is in appliedChanges[0].args.id. ObjectList fields are written as literals: NewThing `initial_values` and ChangeThing `changes` are {0: {key: <field key such as name_text>, value: <expression>}, 1: ...}, and a list field also needs action: "set_list" | "add_list" | "remove_list". APIEvent `parameters` is {<key>: {key, value: <type id>, optional, is_list, in_url}} with the object key equal to `key`; CurrentWorkflowItem then takes that key as param_id.

create_event

Add a field to a data type, including User. The generated field key is in appliedChanges[0].args.name (for example eggs_laid_number or aliases_list_text); use it in expressions and initial_values. Supports references to an existing type, including itself.

create_field

Create a font variable in the Style variables tab. Its id is in appliedChanges[0].args.target_id; reference it in properties as var(--font_<id>_default).

create_font_token

Create a reusable global expression. Bubble suffixes a taken name and generates parameter ids. In the initial expression, GlobalExpressionParameter may name a parameter in properties.param_id and omit global_expression_id. The new expression id is in appliedChanges[0].args.id.

create_global_expression

Create a mobile view with the editor's defaults. The app must have a mobile app. The created view id is in appliedChanges[0].args.id; edit it with set_element_properties and delete it with delete_element.

create_mobile_view

Add a value to an option set. Attribute values are keyed by attribute display name or key. The public option key is appliedChanges[0].args.data.db_value; args.name is an internal id.

create_option

Add an attribute to an option set. Its generated key is in appliedChanges[0].args.name.

create_option_attribute

Create an option set. Its key is in appliedChanges[0].args.name; use create_option and create_option_attribute to populate it.

create_option_set

Create a web page with the editor's defaults, or clone an existing page with its elements and workflows. For newly built UI, pass responsive: true so the page starts in column layout; compose it from row and column containers. The created page id is in appliedChanges[0].args.id. Edit page properties with set_element_properties and delete it with delete_element. Page backgrounds use backdrop_background_style and backdrop_bgcolor (also on the Page_standard_ style). To centre children on a column page, set each child's horiz_alignment to "center"; container_horiz_alignment on the page does not centre them.

create_page

Add a data type privacy rule. Defaults allow viewing all fields, searches, and attachments, with no auto-binding; permissions override these defaults. The response's privacyRules includes rule ids, conditions, and permissions.

create_privacy_rule

Create a reusable element definition. Its id is in appliedChanges[0].args.id; use that id as create_element.type to place an instance, or as parentId/rootId to build inside the definition.

create_reusable

Create a durable version-control savepoint for this app version. Keep the returned timestamp to restore it with restore_savepoint.

create_savepoint

Create an element style. With fromElementId, the style copies that element's current look the way the editor's Create new style does: an unstyled element's own padding, background, border, font, basic conditions and transitions, or a styled element's style plus its own property overrides. Do it before assigning a style, so assigning the new one back changes nothing. Without it, the style starts from the element type's default style. Initial properties are literal styleable values layered on top; an invalid property response lists the legal names. The new style id is in appliedChanges[0].args.name.

create_style

Add functional test descriptions to the app. Returns the created tests with their ids; this does not run the tests.

create_test_cases

Create one record through the app's Data API and return its id. For many records of one type use bulk_create_things. Only the test version is reachable, and only as far as the signed-in user's own access to the app's data allows: reads need view access, writes need edit access.

create_thing

Delete one API Connector call. The collection remains, even when this was its last call; existing references to the call stop working.

delete_api_call

Delete an API Connector collection and every call it contains. Workflows and expressions that reference those calls will stop working.

delete_api_collection

Delete one workflow action. Expressions in later actions that reference its result may become invalid.

delete_action

Delete a development branch by its name from get_versions. Requires explicit confirmation and version-control permissions. Main, live versions, and branches involved in an active merge cannot be deleted. Use a surviving version as appVersion in subsequent tools.

delete_branch

Remove one element conditional by its current zero-based position from get_node. Remaining conditional positions may change.

delete_conditional

Delete a custom state. Expressions that still reference it may become invalid, so inspect the affected root afterward.

delete_custom_state

Soft-delete a data type, which can be restored in the editor. The built-in User type cannot be deleted.

delete_data_type

Delete an element or root and its children. Bubble also deletes workflows attached to it unless keepWorkflows is true.

delete_element

Delete a workflow event and all of its actions.

delete_event

Soft-delete a data type's field, which can be restored in the editor.

delete_field

Delete a global expression. Existing expressions that reference it are left in place and become issues, so run check_app_issues afterward.

delete_global_expression

Delete a privacy rule. The default (everyone) rule cannot be deleted; restrict its permissions with modify_privacy_rule instead.

delete_privacy_rule

Delete an element style. Elements using it fall back to their own values and the element-type defaults; warnings report affected elements and whether it was the default style.

delete_style

Delete one record through the app's Data API. Not undoable; confirm with the user before deleting anything they did not name. Only the test version is reachable, and only as far as the signed-in user's own access to the app's data allows: reads need view access, writes need edit access.

delete_thing

Detach an element or reusable definition from its style while copying the style's values onto it, preserving its current appearance.

detach_style