Configure Salesforce Sandbox for automatic user provisioning with Microsoft Entra ID
In brief
The tutorial adds requirements to enable SOAP API `login()` and grant the integration account API Enabled, Manage Users, and Use Any API Auth permissions. It also documents Salesforce’s December 1, 2026 requirement for Use Any API Auth and related credential errors.
What Entra admins need to know
Enable SOAP API `login()` and configure the integration account permissions to prevent Test Connection and provisioning failures.
This editorial summary was generated by AI from the documentation changes. Verify important details in the full Microsoft Learn article.
Documentation change
The comparison below shows only the changed extract. Use the full-page view for complete context.
Configure Salesforce Sandbox for automatic user provisioning with Microsoft Entra ID
- A Microsoft Entra tenant.
- A valid tenant for Salesforce Sandbox for Work or Salesforce Sandbox for Education. You may use a free trial account for either service.
- A user account in Salesforce Sandbox with Team Admin permissions.
- SOAP API
login()enabled in your Salesforce Sandbox org. Salesforce disables this operation by default for orgs created in Winter '26 and later. In Salesforce Setup, enter User Interface in the Quick Find box, select User Interface, and select Enable SOAP API login(). This action can't be reverted on the User Interface page. For details, see the Salesforce SOAP API login() reference. - A profile for the integration account entered in Admin Username with API Enabled, Manage Users, and Use Any API Auth enabled.
The Admin Username account needs Use Any API Auth because the Microsoft Entra provisioning service signs in through SOAP API login(). Salesforce's Winter '27 release update requires this permission for SOAP API sign-ins in all orgs, including sandboxes, from December 1, 2026. For details, see Assign Use Any API Auth Permission for SOAP login().
Assigning users to Salesforce Sandbox
[!INCLUDE monitor-deployment.md]
Common issues
- If Test Connection fails, verify that SOAP API
login()is enabled in the Salesforce Sandbox org and that the Admin Username account has Use Any API Auth. - SalesforceCredentialValidation: If Test Connection reports "Your Salesforce.com credentials are invalid..." even with a correct password and a fresh security token, check the integration account's Use Any API Auth permission. Salesforce Login History can show successful sign-ins even when this connection fails. If the underlying error is
INSUFFICIENT_ACCESS: SOAP API login() requires the Use Any API Auth user permission, grant Use Any API Auth to the integration account's profile, and then retry Test Connection.
Additional resources
@@ -2,8 +2,9 @@ title: Configure Salesforce Sandbox for automatic user provisioning with Microsoft Entra ID description: Learn the steps you need to perform in Salesforce Sandbox and Microsoft Entra ID to automatically provision and de-provision user accounts from Microsoft Entra ID to Salesforce Sandbox. ms.topic: how-to-ms.date: 03/23/2026-ms.custom: sfi-image-nochange+ms.date: 10/30/2026+ms.custom: sfi-image-nochange, msecd-doc-authoring-1032+ai-usage: ai-assisted # Customer intent: As an IT administrator, I want to learn how to automatically provision and deprovision user accounts from Microsoft Entra ID to Salesforce Sandbox so that I can streamline the user management process and ensure that users have the appropriate access to Salesforce Sandbox. --- # Configure Salesforce Sandbox for automatic user provisioning with Microsoft Entra ID@@ -17,6 +18,10 @@ The scenario outlined in this article assumes that you already have the followin * A Microsoft Entra tenant. * A valid tenant for Salesforce Sandbox for Work or Salesforce Sandbox for Education. You may use a free trial account for either service. * A user account in Salesforce Sandbox with Team Admin permissions.+* SOAP API `login()` enabled in your Salesforce Sandbox org. Salesforce disables this operation by default for orgs created in Winter '26 and later. In Salesforce Setup, enter **User Interface** in the Quick Find box, select **User Interface**, and select **Enable SOAP API login()**. This action can't be reverted on the **User Interface** page. For details, see the Salesforce [SOAP API login() reference](https://developer.salesforce.com/docs/platform/api/guide/sforce-api-calls-login.html).+* A profile for the integration account entered in **Admin Username** with **API Enabled**, **Manage Users**, and **Use Any API Auth** enabled.++The **Admin Username** account needs **Use Any API Auth** because the Microsoft Entra provisioning service signs in through SOAP API `login()`. Salesforce's Winter '27 release update requires this permission for SOAP API sign-ins in all orgs, including sandboxes, from December 1, 2026. For details, see [Assign Use Any API Auth Permission for SOAP login()](https://help.salesforce.com/s/articleView?id=release-notes.rn_api_soap_login.htm&language=en_US&type=5). ## Assigning users to Salesforce Sandbox @@ -104,6 +109,11 @@ The objective of this section is to outline how to enable user provisioning of A [!INCLUDE [monitor-deployment.md](~/identity/saas-apps/includes/monitor-deployment.md)] +## Common issues++* If **Test Connection** fails, verify that SOAP API `login()` is enabled in the Salesforce Sandbox org and that the **Admin Username** account has **Use Any API Auth**.+* **SalesforceCredentialValidation:** If **Test Connection** reports "Your Salesforce.com credentials are invalid..." even with a correct password and a fresh security token, check the integration account's **Use Any API Auth** permission. Salesforce Login History can show successful sign-ins even when this connection fails. If the underlying error is `INSUFFICIENT_ACCESS: SOAP API login() requires the Use Any API Auth user permission`, grant **Use Any API Auth** to the integration account's profile, and then retry **Test Connection**.+ ## Additional resources * [Managing user account provisioning for Enterprise Apps](tutorial-list.md) 