Adding and Removing People

Get your people up and running in HipChat Server. 

This page describes how to add and remove people in HipChat Server.

Adding people

You can add people from your organization by:

This page

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, delegated administrator, or an administrator:
    •  A user can use the HipChat apps to chat with other people in your organization. 
    • A delegated admin can use the HipChat apps to chat and can manage some users and rooms.
    • 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 Info 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 button.

Connecting to an external directory

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 Connecting to an external directory.

Connecting to a SAML identity provider

You can connect HipChat to a SAML 2.0 identify provider, including OneLogin, Okta and Active Directory Federation Services, for user management and single sign on.  See Connecting to a SAML identity provider for single sign-on.

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

This method should only be used for HipChat users who are not synchronized from an external directory. External directory users must be excluded from the synchronization through LDAP filtering to be deactivated properly. In case of using JIRA as your external user management, the user(s) must be deactivated from JIRA's side to ensure that the user remains deactivated on HipChat Server.

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

You can delete one or more user accounts by writing a script that uses Delete User from the HipChat API.

Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

Have a question about this article?

See questions about this article

Powered by Confluence and Scroll Viewport