Salesforce Federated ID Provisioning Error "Username must be in the form of an email address: Username; This Federation ID is already in use"
Jan 19, 2026
Okta Integration Network
Okta Classic Engine
Okta Identity Engine
Overview
When provisioning a user to Salesforce Federated ID, the following error arises:
Automatic provisioning of user <user> to app Salesforce.com (Federated ID) failed: Username must be in the form of an email address (for example, john@acme.com): Username; This Federation ID is already in use. Use a different Federation ID.: SAML Federation ID
Applies To
- User Lifecycle Management
- Salesforce Federated ID
- Provisioning
Cause
Solution
- Change the username being passed to an email format type: john@acme.com.
- The Federation ID for the provisioned user already exists. Change the federation ID to a unique value.
- Attempt to provision the user again and confirm they have been successfully provisioned.
