Salesforce Credentials
Overview
Salesforce credentials that sign in with username, password and security token stop working when Salesforce retires SOAP login() with the Summer '27 release (June 2027). DataBlend's October 2026 1.0 Major release (shipped October 12, 2026) lets an OAuth credential run your existing collectors and data targets over the SOAP API, so you can move off the old login without changing your output.
Username/password credentials keep working until Salesforce turns off login(). Nothing changes for a collector or data target until someone edits it.
What this means for you
Every Salesforce collector and data target that uses a username/password credential must be re-pointed to an OAuth credential before June 2027. The combination of credential type and the toggle decides how DataBlend talks to Salesforce:
Workflows, schedules and downstream queries keep working as long as the collector's output columns stay the same. Choosing OAuth + SOAP is the safest way to guarantee that.
How to transition
The move takes three parts: a Salesforce admin sets up the app once, you create one OAuth credential, then you re-point each collector and data target.
Part 1: Salesforce admin (once per org)
Part 2: Create the REST credential in DataBlend
Part 3: Re-point each collector and data target
Frequently Asked Questions (FAQs)
Salesforce Login Types:
Standard/SOAP (Credentials) - retiring June 2027
REST API (OAuth) - recommended for all new connections
Connect Using Credentials (Standard/SOAP)
Important: Salesforce is retiring SOAP login().
See Platform SOAP API login() Retirement & new Security Requirements | Salesforce Help and SOAP API login() retirement in versions 31.0–64.0 (Summer '27) — how to inventory and migrate integrations to OAuth | Salesforce Help for more information.

If you do not know your Salesforce Security Token, log into Salesforce and click your name at the top of the screen to select Settings. On the left side of the page, navigate to Reset My Security Token and click the Reset Security Token button. A security token will be sent to your email in a few minutes. You will need this token to make API calls to Salesforce from your Mule applications. Save your security token in a secure place or repeat the steps for a different one.
|
Field Name |
Required/ Optional |
Description |
|---|---|---|
|
Name |
Required |
Provide a unique name for this credential. |
|
Environment |
Required |
Select Sandbox or Production. |
|
Base URL |
Optional |
Toggle on to use. In Salesforce, click on Settings > Setup > search for "Custom URLs" under Sites and Domains. |
|
Use REST API |
Optional |
Toggle off to log in with username and password. |
|
Security Token |
Required |
Enter security token for the specific Salesforce user. |
|
Username |
Required |
Enter the Salesforce username. |
|
Password |
Required |
Enter the User password. |
Troubleshooting SOAP API connection:
This will likely be a necessary first step for anyone new to Salesforce. Salesforce removes this option with the Summer '27 release (June 2027). Use a REST API credential instead of setting up a new Standard/SOAP credential.
- Switch to the Classic UI in Salesforce (top right corner under your user area).
- After your display reloads, click Setup in the top right corner to get to the admin area
- In the Quick Find box in the top left, type "User Interface"
- 2/3 down that list of options is the "Enable SOAP API login()" option.
- Check the radio button
- Scroll to the bottom and click Save.
At this point, you can switch back to the Lightning UI and the security token login should work.
Note: If the option's checkbox is greyed out, Salesforce has already turned off SOAP login for your org. Connect using the REST API instead.
Connect using REST API
The REST API can be used to access objects that may not appear in the standard connection. DataBlend can establish a connection with any Salesforce Edition that supports API access:
- Enterprise Edition
- Unlimited Edition
- Developer Edition
- Performance Edition
- Professional Edition, however, the optional Web Services API add-on must be purchased and can be processed through an Account Executive
To establish a connection with Salesforce in DataBlend with REST API, first create DataBlend as an External Client App in Salesforce (a Salesforce admin does this once per org):
- Log into Salesforce and click on the gear icon to navigate to Setup.
- Search for "External Client App Manager" or navigate under the PLATFORM TOOLS section to expand "External Client Apps" and click on "External Client App Manager".
- On the upper-right, click on the "New External Client App" button and refer to Configure Basic Connected App Settings while completing the Basic Information section.
- See Enable OAuth Settings for API Integration for how to set up DataBlend as an app:
- Under the API (Enable OAuth Settings) section, be sure to checkmark "Enable Auth".
- The Callback URL is https://ml.datablend.com/api/plugins/salesforce/oauth.
- Under Selected OAuth Scopes, add the scopes "Manage user data via APIs (api)" and "Perform requests at any time (refresh_token, offline_access)".

- Verify appropriate scopes are enabled in Salesforce by referring to OAuth Tokens and Scopes.

- Under Flow Engagement, checkmark the following.

- Under Security, checkmark Require Proof Key for Code Exchange (PKCE) extension for Supported Authorization Flows.
- Click the Create button.
- When you understand the security risks, accept the warning.
- Select an execution user for the flow.
Although there’s no user interaction in the client credentials flow, Salesforce still requires you to specify an execution user. By selecting an execution user, you allow Salesforce to return access tokens on behalf of this user.
Note Permitted Users policies, such as All users may self-authorize and Admin approved users are pre-authorized, don’t apply to the execution user- From the connected app detail page, click Manage.
- Click Edit Policies.
- Checkmark "Enable Client Credentials Flow" under OAuth Flows and External Client App Enhancements and enter a username (found in View Profile > Personal Information). Click save. For Enterprise Edition orgs, we recommend that you select an execution user who has the API Only User permission.
- Save your changes.
8. In the PLATFORM TOOLS SECTION, expand "External Client Apps" to navigate to “Settings” and toggle on "Allow access to External Client App consumer secrets via REST API". Also check the "OAuth Usage" page.

After Connection is established, create the REST credential in DataBlend.
- Create a new Salesforce credential.
- Toggle ON "Use REST API".
- Select an Environment plus enter the Client ID and Client Secret.
- Click Save.
- Click Connect.
- Click authorize and sign in to Salesforce when prompted. DataBlend stores the tokens and refreshes them automatically.
- Test the credential.

To find the Client ID and Client Secret, log into Salesforce and navigate to the External Client App Manager, then select the DataBlend app. In the Settings tab, expand the OAuth Settings section, click on the Consumer Key and Secret button and enter the Verification Code to access the Consumer Key and Consumer Secret.
| DataBlend | Salesforce |
| Client ID | Consumer Key |
| Client Secret | Consumer Secret |
|
Field Name |
Required/ Optional |
Description |
|---|---|---|
|
Name |
Required |
Provide a unique name for this credential. |
|
Environment |
Required |
Select Sandbox or Production. |
|
Base URL |
Optional |
In Salesforce, search for "My Domain" in the Setup search bar . Copy the "Current My Domain URL". In DataBlend, add "https://" before pasting the URL. After clicking Connect and the page redirects to the Salesforce login page, select to login with a custom URL and paste the "Current My Domain URL" (without https://). |
|
Use REST API |
Optional |
Toggle on to sign in with OAuth. Collectors and data targets that use this credential can still run over the SOAP API with the Use SOAP Transport toggle. |
|
Client ID |
Required |
Enter the Client ID. This is found within the Salesforce user account as Consumer Key. |
|
Client Secret |
Required |
Enter the Client Secret. This is found within the Salesforce user account as Consumer Secret. |
|
Access Token |
Optional |
Do not fill. This field will auto-fill upon valid connection. DataBlend refreshes the access token automatically. |
|
Refresh Token |
Optional |
Do not fill. This field will auto-fill upon valid connection. You only need to click Connect again if the token is revoked in Salesforce or the External Client App changes. |
You may wish to make copies of the original data Targets and collectors. If you do so be sure to switch your workflows from the old collectors and data targets to the ones you just created with the updated ones.
- Open the collector or data target and change its credential to the new REST credential.
- To keep today's output exactly, turn on Use SOAP Transport. Leave it off to move to REST.
- For the collector, look towards the bottom:

- For the data target, look toward the middle of the page:

- Check the API Version. Existing collectors keep their saved version where possible; flipping the toggle resets it to the first valid option for the new transport.
- For a data target with Delete on, leave the toggle off; delete runs over REST only.
- Save, run once, and compare row count and columns with the last run on the old credential.
- Repeat for every object that used the old credential. When none remain, delete the username/password credential.
Frequently Asked Questions (FAQs)
We set up an OAuth (REST) credential. Is it automatically applied to our SOAP collectors?
No. Each collector and data target points to one specific credential, and creating a new credential does not change any of them. Existing objects keep using the username/password credential until someone edits them. There is no automatic migration in this release.
If it isn't automatic, do we need to swap each collector to the new credential?
Yes. Open each collector and data target, select the OAuth credential, and save. To keep the same SOAP output, also turn on Use SOAP Transport. If you skip the toggle, the object runs over REST instead. Swapping is one edit per object; the steps are in How to transition, Part 3.
What happens when a field was available over SOAP but not over REST?
The safest answer is to turn on Use SOAP Transport: the collector then queries the same SOAP API as before, so the fields available today stay available. If you move to REST and a queried field is not available, the run fails with Salesforce's INVALID_FIELD error rather than silently dropping the column. Known differences to watch for on REST:
- File fields such as ContentVersion.VersionData or Attachment.Body return a link over REST. Turn on Download File Content to get the base64 content SOAP returned.
- API version can differ. Legacy SOAP collectors default to 47.0, REST defaults to a newer version, and Salesforce adds or retires some fields between versions. Pick an API version that includes the fields you need.
- Raw JSON (v2-json) changes the output shape to Salesforce's native JSON. It cannot be combined with Use SOAP Transport.
- Blank values can be represented differently on REST and SOAP; check downstream queries that test for blanks.
Does the SOAP Transport take custom fields into account?
Yes. Custom fields (__c) and custom objects work the same way they did with the username/password credential. The query returns whatever fields your SOQL selects, and data targets accept any createable field on the object. One limit: the field and object pickers describe Salesforce at API version 64.0, so objects introduced after 64.0 may not appear in the picker even though queries can still name them.
When do we have to finish?
Before Salesforce's Summer '27 release in June 2027. After that, username/password credentials fail on every run.
Will our runs show a warning until we switch?
Yes. Each run on a username/password credential logs a deprecation warning once. It does not fail the run.
Can we keep the old credential as a backup?
Until June 2027, yes. Delete it once no collector or data target uses it, so nothing is accidentally left on it.
Does an OAuth credential expire?
The access token does, but DataBlend refreshes it automatically using the refresh token. You only re-authorize if the token is revoked in Salesforce or the External Client App changes.
Can our report collectors use SOAP?
No. Report collectors use Salesforce's Analytics API, which is REST only. They need an OAuth credential and have no SOAP toggle.
Additional notes
Every Salesforce collector and data target that uses a username/password credential must be re-pointed to an OAuth credential before June 2027. The combination of credential type and the toggle decides how DataBlend talks to Salesforce:
|
Setup |
Credential |
Use SOAP Transport |
Transport |
Output |
Status |
|
OAuth + REST |
OAuth |
Off (default) |
REST API |
REST results, mapped to the familiar column shape (or raw JSON if API version v2-json is chosen) |
Recommended for new work |
|
OAuth + SOAP |
OAuth |
On |
SOAP API, OAuth token as session |
Same shape as today's SOAP collections |
Use to keep existing output unchanged |
|
Legacy SOAP login |
Username / password / security token |
Not shown |
SOAP API via login() |
Same as today |
Stops working Summer '27 |
What supports the SOAP toggle and what does not:
|
Object |
Use SOAP Transport available? |
Notes |
|
Query collector |
Yes |
API version list changes when the toggle flips |
|
Report collector |
No |
REST only; needs an OAuth credential |
|
Generic data target (upsert) |
Yes |
Batch upsert over SOAP, 200 records per batch |
|
Generic data target with Delete on |
No |
Delete is REST only; the toggle is disabled while Delete is on |
|
Event message data target |
No |
REST only; needs an OAuth credential |