Search Things
bubble.search_things
ActionBusiness appsconnection required
Calls the Bubble API with the connection's credentials.
Read a page of records of a data type, optionally filtered and sorted.
Connection
- Required
- Yes — the node will not save without one
- Auth type
- Bearer token
- Providers
- Bubble
- Secret shape
- the API token, or {"api_token": "…"}
- Config it needs
- base_url, branch, test_data_type
- Resolved by
- config.connection_id, else node.connection_id
Configuration
6 fields, 1 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.
| Field | Type | Required | Default | Constraints | Example |
|---|---|---|---|---|---|
data_type The Bubble data type to work with; Bubble addresses it lowercase with no spaces. | string | Yes | — | — | rentalunit |
constraints Bubble search constraints: a JSON array of objects with 'key', 'constraint_type' and 'value'. | array | No | — | array of object | [{"constraint_type":"greater than","key":"Unit number","value":2}] |
limit How many records to return; Bubble returns 100 when this is left blank. | number | No | — | ≥ 1 | — |
cursor How many records to skip before the page starts; pass the previous page's 'remaining' position to page forward. | number | No | — | ≥ 0 | — |
sort_field The Bubble field to sort the results by. | string | No | — | — | Created Date |
descending Sort from highest to lowest instead of lowest to highest. | boolean | No | — | — | — |
Example configuration
Every value below is the contract’s own example or default — nothing invented.
{
"constraints": [
{
"constraint_type": "greater than",
"key": "Unit number",
"value": 2
}
],
"data_type": "rentalunit",
"sort_field": "Created Date"
}Output
One shape.
result
| Field | Type | Example |
|---|---|---|
results The records on this page, as Bubble returned them. | array | — |
count How many records this page carried. | number | — |
remaining How many records are left beyond this page. | number | — |
cursor The position of the first record on this page. | number | — |
data_type The data type the records came from. | string | — |
{
"count": 0,
"cursor": 0,
"data_type": "",
"remaining": 0,
"results": []
}Related Bubble nodes
See Search Things run in a workflow.
In a technical demo we add the Bubble connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.