Adding and Removing People

• Using the HipChat web app – add individual people, one at a time
• Sending a link to one or more people – invite one person or a group of people, simultaneously
• Configuring your user directories for use with HipChat Server – use your organization's user directories, including popular LDAP directories, Active Directory, Crowd, and JIRA applications, with HipChat Server
• Using the HipChat API – add multiple people, simultaneously

Adding people from the HipChat web app 

You can add individual people, one at a time, to HipChat Server from the HipChat web app. When you add people, HipChat Server sends an email inviting them to join HipChat Server. 

1. Click the Group admin tab.
2. Click the Users tab.
3. Click Add.
4.  in the Full name field, type the first and last name of the person you're adding to HipChat.
5. In the @mention name field, type the name other people will use to mention this person in HipChat. @mentions are a way of getting another person's attention in HipChat rooms. For more information, see HipChat Apps.
6. Type the person's email address in the Email field.
7. Select the person's role. You can make the person a user or an administrator:
   •  A user can use the HipChat apps to chat with other people in your organization. 
   • An admin can use the HipChat apps to chat and has access to the group and server administration features in HipChat Server.

8. Click Add User. HipChat sends an email inviting the person to HipChat. When the person signs up, HipChat adds them to your HipChat  Server group.

Sending a link for signing up with HipChat

You can send one person or a group of people, for example in an email list, a link pointing them to the page where they can sign up for HipChat. 

1. Click the Group admin tab.
2. Click the Features tab.
3. In the Invite URL field, copy the link.
4. Send the link to the people you want to invite to HipChat. The link directs them to a sign-up page. When they sign up, HipChat adds them to your group and gives them the user role.

You can generate a new URL, if the current URL gets compromised. To generate a new URL, click the generate a new URL link.

You can also disable the invite URL, so no one can use the URL to sign up for HipChat. To disable the invite URL, click the disable this feature link.

Configuring your user directories for use with HipChat Server

You can use your organization's user directories, including popular LDAP directories, Active Directory, Crowd, and JIRA applications, with HipChat Server. For the full list of supported user directories and instructions on configuring them with HipChat Server, see Configuring User Directories.

Adding people using the HipChat API

You can add multiple people, simultaneously, by writing a script that uses the Create User method from the HipChat API.

Changing people's roles 

You can change a person's role from the user to the admin role or vice-versa.

1. Click the Group admin tab.
2. Click the Users tab.
3. Select the user's name.
4. From the Role menu, select the role you want to give the user. 
5. Click Save.

Removing people and deleting user accounts

To remove a person's access to HipChat Server you need to delete their user account. (Deleted accounts can be reactivated.)

You can delete one or more user accounts, simultaneously.

1. Click the Group admin tab.
2. Click the Users tab.
3. Select the users you want to delete.
4. Click the Delete button.

You can reactivate deleted user accounts.

1. Click the Show deleted users button.
2. Select the users you want to reactivate.
3. Click the Restore button.

Removing people using the HipChat API