How to integrate Salesforce with Bubble

Log in to Salesforce and go to Setup (gear icon → Setup). In the Quick Find search box, type 'App Manager' and click on it. Click 'New Connected App.' Fill in the required fields: Connected App Name (e.g., 'Bubble Integration'), API Name (auto-fills), and Contact Email. Under API → Enable OAuth Settings, check the box. Set the Callback URL to https://yourapp.bubbleapps.io/api/1.1/oauth_redirect. Under Selected OAuth Scopes, add 'Full access (full)' and 'Perform requests at any time (refresh_token, offline_access).' Click Save. Wait 2-10 minutes for the app to be ready, then copy the Consumer Key (Client ID) and Consumer Secret.

In Bubble, go to Plugins tab → API Connector → Add another API. Name it 'Salesforce.' Set Authentication to 'OAuth2 User-Agent Flow.' Fill in the fields: App ID = your Salesforce Consumer Key, App Secret = your Salesforce Consumer Secret, Scope = full refresh_token, Authorization URL = https://login.salesforce.com/services/oauth2/authorize, Token URL = https://login.salesforce.com/services/oauth2/token. Click 'Authenticate' — a Salesforce login window opens. Log in with your Salesforce credentials and authorize the app. After redirect, Bubble stores the access and refresh tokens.

Add an API call in the Salesforce group named 'Create Lead.' Set method to POST, URL to https://yourinstance.salesforce.com/services/data/v59.0/sobjects/Lead. Add Header: Content-Type = application/json. The body should include Lead fields as parameters: FirstName, LastName, Email, Company, Phone. Set 'Use as' to Action. Initialize the call with test data. Now on your Bubble form page, create a workflow: When Submit is clicked → Call 'Create Lead' action with the form input values mapped to the parameters. The API returns the new Lead's Salesforce ID.

1POST /services/data/v59.0/sobjects/Lead
2
3Body:
4{
5  "FirstName": "<dynamic_first_name>",
6  "LastName": "<dynamic_last_name>",
7  "Email": "<dynamic_email>",
8  "Company": "<dynamic_company>",
9  "Phone": "<dynamic_phone>",
10  "LeadSource": "Bubble App"
11}

Add an API call named 'Query Contacts.' Set method to GET, URL to https://yourinstance.salesforce.com/services/data/v59.0/query?q=[soql_query]. Add a parameter called soql_query. Set 'Use as' to Data so you can bind results to Repeating Groups. Initialize with a sample query like SELECT Id, FirstName, LastName, Email FROM Contact LIMIT 10. The response includes a records array. In your Bubble page, add a Repeating Group with Type: Query Contacts result, Data source: Get data from external API → Salesforce - Query Contacts, with the soql_query parameter set dynamically (e.g., from a search input).

Salesforce returns a maximum of 2,000 records per query. For larger datasets, the response includes a nextRecordsUrl field. Create a second API call named 'Get Next Records' with GET method and URL set to https://yourinstance.salesforce.com[nextRecordsUrl]. After calling the initial query, check if the response's done field is false. If so, call 'Get Next Records' with the nextRecordsUrl value to fetch the next batch. In your workflow, you can use a recursive backend workflow: call the query, process the records, and if done = false, schedule the same backend workflow with the nextRecordsUrl.

Add an API call named 'Update Contact.' Set method to PATCH, URL to https://yourinstance.salesforce.com/services/data/v59.0/sobjects/Contact/[salesforce_id]. Add a parameter salesforce_id for the record's Salesforce ID. The body contains only the fields you want to update. Set 'Use as' to Action. In your Bubble workflow, call this action with the Salesforce ID stored in your Bubble database and the updated field values. A successful update returns status 204 (no content). For bidirectional sync where Salesforce changes flow back to Bubble, RapidDev can help set up Salesforce outbound messages or platform events connected to Bubble backend workflows.

1PATCH /services/data/v59.0/sobjects/Contact/<salesforce_id>
2
3Body:
4{
5  "Phone": "<dynamic_new_phone>",
6  "Email": "<dynamic_new_email>"
7}