Skip to content
English
  • There are no suggestions because the search field is empty.

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)

Salesforce Standard SOAP Credential

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.

  1. Switch to the Classic UI in Salesforce (top right corner under your user area).
  2. After your display reloads, click Setup in the top right corner to get to the admin area
  3. In the Quick Find box in the top left, type "User Interface"
  4. 2/3 down that list of options is the "Enable SOAP API login()" option.  
  5. Check the radio button
  6. 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):

  1. Log into Salesforce and click on the gear icon to navigate to Setup.
  2. 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".
  3. 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.
  4. See Enable OAuth Settings for API Integration for how to set up DataBlend as an app:
    1. Under the API (Enable OAuth Settings) section, be sure to checkmark "Enable Auth".
    2. The Callback URL is https://ml.datablend.com/api/plugins/salesforce/oauth.
      1. Under Selected OAuth Scopes, add the scopes "Manage user data via APIs (api)" and "Perform requests at any time (refresh_token, offline_access)".
    3.  Verify appropriate scopes are enabled in Salesforce by referring to OAuth Tokens and Scopes.
    4.  Under Flow Engagement, checkmark the following.
      Salesforce - Flow Engagement and Security
    5. Under Security, checkmark Require Proof Key for Code Exchange (PKCE) extension for Supported Authorization Flows.
  5. Click the Create button.
  6. When you understand the security risks, accept the warning.
  7. 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  
    1. From the connected app detail page, click Manage.
    2. Click Edit Policies.
    3. 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.
    4. 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.


Salesforce - Settings - REST API

After Connection is established, create the REST credential in DataBlend.

  1. Create a new Salesforce credential.
  2. Toggle ON "Use REST API".
  3. Select an Environment plus enter the Client ID and Client Secret.
  4. Click Save.
  5. Click Connect.
  6. Click authorize and sign in to Salesforce when prompted. DataBlend stores the tokens and refreshes them automatically.
  7. Test the credential.

Salesforce REST API 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.
 
Re-point Collectors and Data Target that use SOAP credentials with REST credentials
Creating a REST API credential doesn't change any existing collectors or data targets. Each one keeps using its current credential until you edit it. Before June 2027, open each collector and data target that uses a Standard/SOAP credential and select the REST API credential. To keep the output exactly the same, also turn on Use SOAP Transport.
 
It is highly recommended to test on a copy of the collector or data target in a sandbox first if possible and the output feeds a production workflow.

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. 

  1. Open the collector or data target and change its credential to the new REST credential.
  2. To keep today's output exactly, turn on Use SOAP Transport. Leave it off to move to REST.
  3.  For the collector, look towards the bottom:
  4.  For the data target, look toward the middle of the page:
  5.  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.
  6.  For a data target with Delete on, leave the toggle off; delete runs over REST only.
  7.  Save, run once, and compare row count and columns with the last run on the old credential.
  8.  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

 
Additional Resources