Manage Users

Users are created in the User Management view or on-the-fly when an action is logged for a user ID. If an action is logged for a user ID that doesn't exist, a new record is created and all subsequent action data is associated with the new record.

Create a User

1. Open Nitro Studio > Activity > Users.
2. Click New.
3. Set user properties:

Field	Description
User ID	The user's gamification ID. The user ID is used to make API calls, so choose an identifier that you always have access to wherever you need to make a call. This may be the user's GUID, username, email, or other identifier.
First Name	The user's first name. The name is stored as a preference.
Last Name	The user's last name. The name is stored as a preference.
user image	The user's photo/avatar image. The image is stored in the userPhotoUrl preference.

4. Click Save or Save & add another.

Add User Details

If a user is created by logging an action, you can add user details such as first name, last name, or other custom data after the user is created using preferences. User preferences are managed in the User Management view, via data import, or with the PUT /users/{userId} method.

You can authenticate users for Impact+ using data import, APIs, or individually on the Impact+ tab in the User Management view.

Change a User's Point Balance

An administrator can manually edit a user's point balance using Nitro Studio or APIs.

Scenario	Method
Single user Any point category	Use the User Management view > Balances tab and change the balance of the appropriate point category.
Multiple users Any point category	Use data import to upload a file of users and credits or debits. Use POST /users/{userId}/point-transactions to add points to the user's balance or PUT /users/{userId}/point-balance to set the user's balance to some amount. Set an initial credits amount on the point category to credit users as they're added to the program.

Delete a User

Deleting a user removes all their data and accumulated rewards. You can delete a single user in the User Management view by clicking Delete () on the user's detail page. To delete all users, an account reset or new API Key is required. Contact Nitro Support to make this request.

If you have a mission limited to a number of missions or points and you delete a user that earned points for completing that mission, the deleted user's points are not added back to the mission limit threshold.

Note: If you are deleting anonymous users because you no longer want to have them in your program, you will also need to find and remove where actions are being logged for the anonymous users. Removing the actions will stop additional anonymous users from being created.

Change a User ID

Contact Nitro Support if you need to change a user ID. Your account team will complete the following steps. Show me

When changing a user ID, the user’s new ID cannot already exist in Nitro. If the ID does exist, extra steps are required to change the ID.

Step 1

1. Open Nitro Studio > Activity > Users.
2. Open the detail view for the user you want to edit (e.g. OldUser).
3. Click Edit ().
4. In the New User Id field, enter the user's new ID (e.g. NewUser).
5. Click Save.
6. If the change was successful, stop here and continue to Step 4. If the change was unsuccessful because the user ID already exists, continue to Step 2.

Step 2

Complete this section only if the message from Step 1 indicates that the new user ID already exists.

1. On the Swagger site, open the GET /users/{userId}/actions API.
2. Set User ID to the new user ID you want to use (e.g. NewUser).
3. Click Execute.
4. Check the response:
   1. If the user has any action history records, stop here and continue to Step 3.
   2. If there are no action history records for the user ID, it is safe to delete that user.
      1. Open the user in the User Management view (e.g. NewUser).
      2. Click Delete (), and then confirm the deletion.
      3. Repeat Step 1 to change the user's ID.
      4. Continue to Step 4.

Step 3

Complete this section only if the API response from Step 2 returns action history records for the new user ID. This will move the action history to a new user.

1. Open Nitro Studio > Activity > Users.
2. Open the detail view for the user ID that you want as the new user ID (e.g. NewUser).
3. Click Edit ().
4. In the New User Id field, enter a user ID that you'll delete later(e.g. DISCARD_NewUser).
5. Click Save.
6. In the User Management view, open the detail view for the original user from Step 1 (e.g. OldUser).
7. Click Edit ().
8. In the New User Id field, enter the user's new ID (e.g. NewUser).
9. In the Users view, open the "to delete" user's details (e.g. DISCARD_NewUser).
10. Review the action history to determine what needs to be moved to the user's new ID (e.g. NewUser). You can manually complete missions or create an actions file for import depending on the number of items you feel are important to move.
11. (Optional) Once all action history is moved to the new user, you can delete the "to delete" user (e.g. DISCARD_NewUser). Or, you can leave this user in Nitro.
12. Continue to Step 4.

Step 4

If necessary, fix the user's registration information.

• If you're not using Impact+, stop here.
• If you're using Impact+, ensure the correct auth mapping is set up and active for the new ID.

See also

Group management

Studio users

Preferences