Auth0 enhanced Bulk User Import to support bulk updating select user attributes using the upsert parameter. The upsert parameter can be either set to “true” or “false” during bulk user import and it impacts “pre-existing” users in Auth0. When using bulk user import for the first time you would not bother with upsert since it is only meant to update existing records. However, if you want to run an import again on existing users (by appending more users or upserting fields on existing users), the upsert parameter may be useful. You can use this to do things like update name values from marital status changes or add pictures.
If upsert parameter is set to
false (default value) during a bulk user import, pre-existing users that match on email address will not be updated. When set to
true, pre-existing users that match on email address will be updated, but only with upsertable attributes. Note: Prior to this release, if you used the upsert parameter and did not specify values for app_metadata, user_metadata or email_verified, those attributes would be replaced with null values. With this update, upsert will not replace those attributes will null values and you can now more efficiently implement bulk user imports for the following select attributes.
There is no action required by you and you can start taking better advantage of the Bulk User Import capability today. To get started check out the Bulk User Imports documentation and to see a full list of attributes supported see our User Profile Attributes.
As with many other changes to our product, this improvement came from feedback from our valued community. So, if you have feedback on how we can continue to make our product better, please let us know through this form. We're always listening and it is super easy!