How to Create and Modify Records via Bubble's Data API

Open your Bubble editor and navigate to Settings in the left sidebar. Click the API tab. Under 'Enable Data API', toggle the switch to ON. You will see a list of your Data Types below — check the box next to each Data Type you want to expose via the API. For each enabled type, toggle individual permissions: Create, Modify, Delete, and View. Make sure to enable at least 'Create' and 'Modify' for the types you need. Copy your API token displayed at the top of this page — you will need it for authentication.

Bubble's Data API endpoints follow a predictable pattern. For creating a new record, the URL is: https://yourapp.bubbleapps.io/api/1.1/obj/datatypename. Replace 'yourapp' with your app name and 'datatypename' with your Data Type name in lowercase with spaces replaced by hyphens. For the development version, use: https://yourapp.bubbleapps.io/version-test/api/1.1/obj/datatypename. To modify an existing record, append the record's unique ID to the URL.

1# Endpoint patterns:
2
3# Create a new record (POST)
4https://yourapp.bubbleapps.io/api/1.1/obj/product
5
6# Modify an existing record (PATCH)
7https://yourapp.bubbleapps.io/api/1.1/obj/product/1234567890x12345
8
9# Development version endpoints
10https://yourapp.bubbleapps.io/version-test/api/1.1/obj/product

Open your API testing tool and create a new POST request. Set the URL to your Data Type's create endpoint. Add an Authorization header with the value 'Bearer YOUR_API_TOKEN'. Set the Content-Type header to 'application/json'. In the request body, include a JSON object with your field names as keys and the values you want to store. Field names must match exactly what you defined in Bubble's Data tab (case-sensitive). For related data type fields, pass the Unique ID of the related Thing.

1{
2  "product_name": "Premium Widget",
3  "price": 29.99,
4  "description": "A high-quality widget for professionals",
5  "in_stock": true,
6  "category": "1678901234x567890"
7}

To update an existing record, create a PATCH request to the endpoint with the record's unique ID appended. Use the same Authorization and Content-Type headers. In the request body, include only the fields you want to change — you do not need to send all fields. Bubble will update only the specified fields and leave everything else unchanged. To clear a field, set its value to null in the JSON body.

1{
2  "price": 24.99,
3  "in_stock": false
4}

For list fields, pass an array of values in the JSON body. For lists referencing another Data Type, pass an array of unique IDs. To add items to an existing list without replacing it, first GET the current list, append your new items, then PATCH the full array back. For file and image fields, pass the publicly accessible URL — Bubble will download and store it. You cannot upload binary data directly through the Data API. For complex integrations, consider using a backend API workflow with RapidDev's assistance to handle the orchestration.

1{
2  "tags": ["premium", "sale", "featured"],
3  "related_products": ["1678901234x567890", "1678901234x567891"],
4  "product_image": "https://example.com/images/widget.png"
5}

Before pointing external services at your live app, always test against your development version. Use the version-test endpoint URL for testing. Check your Bubble Data tab → App data to verify records were created or modified correctly. Look at the Logs tab for errors. Once everything works in development, switch to the live endpoint (without version-test) and deploy your app to ensure API changes are active in production.