Salesforce rescue

US · UAE · Global

One login, four vendors: when a shared Salesforce integration user should be split

By Shivanath DevinarayananPublished 7 min read
Written forThe Salesforce owner with an org that isn't working“Our Salesforce org is stuck.”

The short answer

When should a shared Salesforce integration user be split into one user per integration?

Split it when two or more integrations write data, when it holds the System Administrator profile, or when one vendor's bad password can lock out another's sync. Keep it only for one read-only feed with one owner, and retire any line nobody owns. At Mindcat, we write that call for each line in a rescue week.

A key ring with four coloured tags locked by one padlock, with the words Locked out: all four

Takeaways

  1. 01One wrong password from one vendor can lock a shared integration user, and every other integration on it stops too.
  2. 02Salesforce recommends one user for every integration, for control, traceability and a smaller impact if one is compromised.
  3. 03Enterprise, Unlimited and Performance orgs get five Salesforce Integration licences at no extra cost.
  4. 04Changing a user to the Integration licence removes its permission set assignments. Assign the permission set licence first, then test in a sandbox.
  5. 05Every integration on the username-password flow re-authenticates before 20 February 2027 anyway, so split while you are in there.

If one Salesforce user's password sits in four vendors' settings, this is for you. That shared integration user saves licences on paper. It also means one vendor's mistake can stop every other sync in the org, and nobody can tell from a record which system changed it. This is not for you if your org has no integrations, or no named Salesforce admin or owner to make the call.

What goes wrong when every integration shares one user?

One bad password stops all of them. A Salesforce architect who teaches on stevetecharc.com describes a client with a single integration user. A middleware platform used it to send updates "a couple of times a second" all day. A second team shipped a new component on the same user with the wrong password, tried three times, and locked it out.

Both integrations stopped, because it was one user. Every reset locked it again within seconds, because the first integration kept retrying with a valid username on a locked account. The fix was to ask the second team to stop, then wait.

Flow: a middleware sync and a new component share one user, a wrong password locks it, and both integrations stop
One wrong password, two stopped syncs.

The other cost is quieter. When every integration writes as "Integration User", Created By and Last Modified By name nobody. A wrong price on an order could have come from the ERP, the e-commerce site or the billing tool, and the record will not say which.

Practitioners say the same about why it happens. Danny Gelfenbaum, head of delivery at a Salesforce consultancy, wrote on LinkedIn in July 2024 that many companies combine all integrations into one user and give it "VERY privileged permissions, usually a System Admin profile... Not best practice. At all. But it is cost-efficient."

What does Salesforce recommend?

One user for every integration. Salesforce Help says, "Following the principle of least privilege, we recommend creating and configuring one Salesforce user for every integration." It gives three reasons: "more control over operations", "traceability of transactions", and it "minimizes the impact if a user or integration is compromised."

The licence for it costs most orgs nothing to start. The Salesforce Admins blog says Enterprise, Unlimited and Performance Edition orgs are provisioned with five Salesforce Integration user licences at no additional cost, and Developer Edition orgs with one. For more, Salesforce says to contact your account executive.

ItemWhat Salesforce says
RecommendationOne Salesforce user for every integration
IncludedFive licences on Enterprise, Unlimited and Performance; one on Developer Edition
ProfileMinimum Access - API Only Integrations
ScreensNo user interface access; API-only cannot be turned off
Extra permissionsThrough the Salesforce API Integration permission set licence, then permission sets
Sign-inREST: an external client app with an OAuth 2.0 flow. SOAP and Bulk: the login() call

The Admins blog, updated in October 2025, adds a step that only works with separate users: set Login IP Ranges on each application's profile to the vendor's published addresses. The blog's reason: even if credentials stored by a vendor are stolen in an attack on that vendor, "an unauthorized actor still cannot access your Salesforce org." Check the app's IP relaxation setting too, so the range is enforced for its tokens. A shared user can only be locked to the addresses of every vendor at once.

Separate users also let you stop one vendor in an incident. Freeze or deactivate that integration's user, and the other syncs keep running.

How do we decide: split, keep or retire?

Start with a list, not a licence count. Write one line for everything that signs in as the shared user, with four columns: the system, what it reads, what it writes, and the one person who can approve a change to it.

  1. 01List every system that signs in as the shared user. Ask the admin, read the vendor contracts, and filter Login History to that username: the Source IP and Application columns usually tell the vendors apart.
  2. 02Next to each, write the objects it reads.
  3. 03Write the objects it creates, edits or deletes. 'Nothing' is an answer.
  4. 04Write its owner: the one person who can say yes to a change.
  5. 05Give the line a call: split, keep or retire.

Then apply the rule. This is our rule of thumb, not a Salesforce rule.

What the list showsThe callWhy
This line writes data, and another line writes as the same userSplitCreated By has to name the system that changed the record.
This line runs on a System Administrator profile it does not needSplitEach integration should get only the objects its job needs.
This line's password or retries can lock out another lineSplitA failure should stop one integration, not all of them.
A read-only feed with one owner, left alone on the user once the others moveKeepIt stays on the current user, moved to the Integration licence and cut down to its own objects.
Nobody can say who owns it or what stops without itRetireSwitch it off in a sandbox first and ask the people who use the data.

Here is what the list looks like on a sample org. The org and every line are invented; the shape is the one we write.

SystemReadsWritesOwnerCall
ERP order syncAccounts, productsOrders, invoices
Marketing toolLeads, contactsLeads, campaign members
Backup serviceEvery objectNothing day to day; everything on a restore
BI dashboard feedOpportunitiesNothing
Old survey connectorContactsUnknown

Five lines: three splits, one keep, one retire. That is four Integration users, which fits the five licences an Enterprise org includes, with one to spare. The backup line is a split even though it rarely writes, because a restore writes everything, and you want that run named on every record it touches. Test it in a sandbox before anything else: a backup tool needs read access to every object, so it is the line most likely to hit a permission the Integration licence does not allow.

Decision chart: one line per system, then split if it writes or has admin rights, keep one read-only feed, retire if unowned
Any split reason wins.

A line that hits any split row is split, even if the others say keep. A line with no owner is the real finding: someone in the org has to own it before anyone touches its permissions.

If more than half the lines end in "nobody knows", that is a failed-project rescue, not a licence task.

Where does the switch go wrong?

In the order of the steps. Eric Kintzer, an admin who moved thirteen integration users to five free and eight purchased Integration licences in January 2024, wrote down three traps.

  • The licence change removes permissions. Changing a user from the Salesforce licence to Salesforce Integration "has the effect of deleting all the permission set and permission set group assignments", he wrote. Public group membership stayed.
  • The permission set licence comes first. Assign the Salesforce API Integration permission set licence before any permission set, or the assignment fails with "permission not supported".
  • Some permissions are not allowed. A permission set for this licence cannot hold Visualforce pages or the Lightning Experience User permission. One vendor he used needed Visualforce access, so it could not move.
Five steps: test in a sandbox, change the licence, assign the permission set licence, reassign permission sets, test
Switch in this order, sandbox first.

He also tested one worry: changing the licence did not break the sign-in already in place.

The Salesforce Admins blog adds two of its own: "Not all integrations work with this license. Check with the vendor," and configure the API-only profile in a sandbox before production. Vendor support changes, so read each vendor's documentation on the day you plan the move.

Why do it before 20 February 2027?

Because many of these integrations have to sign in again anyway. On 20 February 2027, Salesforce stops the OAuth username-password flow for connected apps, with no opt-out. If the shared user's password sits in vendors' settings, check which of those integrations use that flow.

We covered how to find those integrations and what replaces the flow in which integrations stop on 20 February 2027. If each one needs new credentials before the deadline, giving it its own user at the same time costs one extra row in the plan. Splitting later means changing credentials in every vendor's settings twice.

An admin at a night desk moving tags from one shared key ring onto separate hooks on a board
One hook per integration.

What would we do first?

At Mindcat, we start a rescue week from the list above. We get read-only access on day 1, read Login History and every user that an integration signs in as, and write one line per integration: what it reads, what it writes, who owns it, and the call. The week ends with a written call on the org, finish, cut or rebuild, with the reasons and the first fix. You can see a sample read, on an invented org, before you send us anything.

The assessment is free: a short read of the org and a written note. If you go ahead, the first build week is a fixed AED/SAR 14,900 (about USD 4,050), credited in full when you sign the build within 60 days. We will not fix-price a rescue we have not assessed. If the list turns into integrations you want rebuilt properly, our Salesforce integration work covers it.

Not for you if your org has one integration, or no named admin or owner yet. Name the owner first, then make the list.

Filed under

Salesforce rescuesalesforce integration user licensesalesforce one user per integrationminimum access api only integrations profilesalesforce api integration permission set license
Useful to someone on your team?

FAQ

Questions teams ask next

How many Salesforce Integration user licences do we get?
The Salesforce Admins blog says Enterprise, Unlimited and Performance Edition orgs are provisioned with five Salesforce Integration user licences at no additional cost, and Developer Edition orgs with one. Salesforce Help says more add-on licences are available to buy; ask your Salesforce account executive for the price on your contract.
Can an integration user with the Integration licence log in to the Salesforce screens?
No. Salesforce Help says users on the Salesforce Integration user licence are not authorised to reach Salesforce data or features through any user interface, and that you cannot turn off the API-only access granted by the Minimum Access - API Only Integrations profile.
Does every vendor support the Salesforce Integration licence?
Not always. The Salesforce Admins blog notes that not all integrations work with this licence and tells you to check with the vendor. Read each vendor's current documentation, and test the integration in a sandbox before you change the user in production.
Will changing the licence break the integration's existing sign-in?
One admin who moved thirteen integration users found that changing the licence did not affect authentication already in place. The same change did delete the user's permission set and permission set group assignments, so plan to reassign them straight away and test each integration's reads and writes.

Sources

  1. 01Salesforce Help: Give Integration Users API Only AccessAccessed 16 Nov 2026
  2. 02Salesforce Admins: Best Practices for Configuring Your Integration User (updated 23 October 2025)Accessed 16 Nov 2026
  3. 03Salesforce release notes: Assign the New Salesforce Integration User License to Grant API Only AccessAccessed 16 Nov 2026
  4. 04Steve Tech Arc: Different Users, Different Doors (the integration user that locked itself out)Accessed 16 Nov 2026
  5. 05Danny Gelfenbaum on LinkedIn: Salesforce Integration User is HORRIBLE (1 July 2024)Accessed 16 Nov 2026
  6. 06Cropredy SFDC: Migrating to Salesforce Integration User Licenses (January 2024)Accessed 16 Nov 2026
Shivanath Devinarayanan, founder of Mindcat

Written by

Shivanath Devinarayanan

Founder, Mindcat Consulting · Salesforce MVP Hall of Fame

Builds and runs AI agents in production. Reads every brief that comes in and signs the work that goes out.

About Shivanath

Rescue and Optimize · the written assessment

We work in real estate and right now, our Salesforce org is stuck.

Industry
Problem

Brief: Real estate. Leads from portals and WhatsApp. Follow-up has no owner. The org is stuck. Stabilise first, then decide what is worth finishing. From: /blog/salesforce-integration-user-split.