SAP Knowledge Base Article - Public

2825052 - Assignment ID


Assignment ID is an identifier assigned to a person to define the relationship between the person and a company. You can use it to identify users and change it if needed.

IMPORTANT NOTE: Currently, assignment ID is NOT supported in some SAP SuccessFactors areas, for example, Learning, Compensation, Onboarding and data protection and privacy features. This might cause display inconsistencies across the suite. For further details on this see Important Notes about Assignment ID . If you wish to proceed with assignment ID change you must Contact SAP Professional Services to evaluate potential risks prior to changing assignment id's.

"Image/data in this KBA is from SAP internal systems, sample data, or demo systems. Any resemblance to real data is purely coincidental."


SAP SuccessFactors HCM Suite


Warning : Assignment ID is a new unique identifier and we don’t recommend changing this frequently or for non support areas for example Learning, Compensation and Onboarding. For further details on this see Important Notes about Assignment ID - If you wish to proceed to change assignment ID in non supported areas outlined on the Important notes section before making any changes, we recommend that you contact SAP Professional Services to evaluate the risks associated with the inconsistencies.

You will see an additional column called ASSIGNMENT_ID_EXTERNAL in the user data file of import and export tools. By default, the user data template contains the Assignment ID column, the Assignment ID is the same as the UserID.

Note: In Employee Central-enabled instances, if you have used a business rule to generate assignment IDs, the system creates assignment IDs based on the rule and the assignment IDs might be different from the user IDs. When you create new users using the user management tools such as Employee Import, Manage Users, or OData APIs, assignment IDs for these users are also added to the system.

If you don't want to include assignment ID in the user data file, select Exclude Assignment ID Column from the User Data Template in Admin Center > Platform Feature Settings. There is no impact excluding the assignment ID as the field will default to Userid see below:


Importing and exporting Assignment ID.

When you add or update user data using Employee Import, user ID is required while assignment ID is optional in the template. Note that assignment ID is in the last column. If you don’t input a value in the Assignment ID column, the system will populate the value from user ID to assignment ID after the import job completes.

If you provide assignment ID for new users in the import file, different values can be input for userId and assignment id external .

For more details see Assignment ID in User Management SAP Help Guide.

Note: Assignment ID's can only be changed through the "convertAssignmentIdExternal" function import see more details 2820644 - [1908 Feature] API-12250: Add new attribute assignmentIdExternal in User OData API

What is the difference between Assignment ID and User ID?

Assignment ID (assignment-id-external) can be changed whereas a User ID (users-sys-id) cannot be changed in the system.

Read the following table to find the differences and relationships between person ID, UUID, user ID, and assignment ID see SAP Help Link - Differentiating Between Person ID, UUID, User ID, and Assignment ID

How can I change the Assignment ID?

To ensure system stability, you should not change assignment ID frequently or randomly. Overly frequent changes to assignment ID can create an unnecessary burden on the system.

It is only possible to change the assignment ID through the "convertAssignmentIdExternal" function import see more details 2820644 - [1908 Feature] API-12250: Add new attribute assignmentIdExternal in User OData API

To Grant permission to allow you to change assignment ID through convertAssignment External go to under manager user -> Change Assignment ID


If your requirement is to change assignment ID this can only be achieved through the "convertAssignmentIdExternal" function import see more details 2820644 - [1908 Feature] API-12250: Add new attribute assignmentIdExternal in User OData API and SAP Help ConvertAssignmentIdExternal if you have questions relating to the import please engage with Integrations under the component LOD-SF-INT-ODATA.


Assignment ID , ASSIGNMENT_ID_EXTERNAL , Assignment ID , convertAssignmentIdExternal , UserId conversion , change assignment ID , field in user data file , KBA , LOD-SF-PLT , Platform Foundational Capabilities , Problem


SAP SuccessFactors HXM Suite all versions