How do I provision new users in my Ashby account manually?
16 min
this guide covers how to add, deactivate, and reactivate employees as users in your ashby account if you have scim enabled, all users are synced via scim, so adding users manually or via user sync is overridden permissions & prerequisites only organization admins can manually manage users or edit user permissions adding new users if you have user sync enabled if you have the google workspace or microsoft 365 integrations in place and allow users to sync over automatically, any new users are automatically provisioned once they're added to your tenant to check if you have user sync enabled, an organization admin can take the following steps navigate to admin > integrations > integrations click on the google workspace or microsoft 365 integration panel (depending on the integration you are using) for google workspace integrations, confirm whether the sync google workspace users? and/or automatically enable synced users? checkboxes are checked sync google workspace users? when checked, users set up in your connected google workspace sync to ashby automatically automatically enable synced users? when checked, synced users are enabled so they can be configured and scheduled for interviews before they have signed into ashby for microsoft 365 users, confirm whether the sync microsoft users? and automatically enable synced users? checkboxes are checked sync microsoft users? automatically syncs users in your microsoft tenant into ashby automatically enable synced users? automatically syncs and enables users from your connected microsoft tenant so they can be configured and scheduled for interviews before they have signed into ashby if you are not seeing a user being synced and active as expected and you've checked the settings above, check that the user is active in your workspace or tenant adding new users to ashby manually if you are not using the user sync option, or have user sync on and want to add users outside of your workspace or tenant, you can add them manually provisioning a new user to add a user manually navigate to admin > organization setup > employees https //app ashbyhq com/admin/users click new and enter the user's name and email address click create complete any other details in the user's profile the user shows as a new unprovisioned employee initially to activate their account, click actions on their profile, then activate the new user can now log into ashby and you can assign their permissions for more on permissions and access roles, see user permissions deactivating and terminating users in ashby you can deactivate or terminate an active user or employee account if they shouldn't have access to ashby deactivating an account means the user loses access to ashby and is downgraded to limited access upon reactivation terminating an account means the user loses access to ashby and all of their access roles are also removed from their profile to deactivate or terminate a user account navigate to admin > organization setup > employees and click on the user in question click actions on their profile, then deactivate or terminate what is the difference between deactivated and terminated users? deactivating a user is recommended when they are still with your company but you no longer want them to have access to ashby terminating a user removes all of their access roles and stops their access to ashby, so this option is recommended when the user is no longer with the company deactivating or terminating an employee removes them from interviewer pools, but deactivating an employee does not remove them from an interview they've already been scheduled to participate in interviews need to be manually rescheduled with a new interviewer reactivating a user profile in ashby to reactivate a user's account in ashby, adjust the is active? filter that shows all active users by default on the employees page the filter can show up in two different formats, depending on whether you have basic or advanced filters toggled on advanced filters off advanced filters on once you've adjusted the filtering as needed, locate and click on the profile you'd like to reactivate, click actions , then activate to reactivate the user profile when reactivating a deactivated employee, they will reactivate as a limited access user you will need to upgrade them to elevated access for any previous access roles to be restored faq can i import employees in bulk? you can import a csv file of employee data to create or update employee profiles in ashby for more on this, see bulk import options docid\ sorncj66lghrflracxetj when adding a user's email to their profile, i see "this email is already used by another user " why? this is because a user with this email address already has a profile within your account view your deactivated and terminated user list, as they should be listed there (for more on amending those filters, see the reactivating a user profile section above) you can then head into their profile, click actions , then activate to reactivate their profile will newly added and activated users receive an email confirming their access or inviting them to log in to ashby? no, new users do not receive an email notification with an invite, but as soon as their account is active, they can sign in at https //app ashbyhq com/signin https //app ashbyhq com/signin share this link with them so they can log in for the first time can i view all users (activated, deactivated, and terminated) in one list? yes — remove the default filter that only pulls active users to view the full user list click the trash can icon to the right of the filter to remove it can i add external recruiters as users? you can if these users should only be able to view candidate profiles linked to their agency, see agencies setup for more information on setting up agency users can i amend an employee's email on their profile? if an employee's email has changed (or if there was a typo in the entered email when their account was initially created), click into their profile on the employees page, then edit the email address listed in the email section of basic info can i delete a user/employee in ashby? users listed on the employees page can currently have their profiles deactivated or terminated it is not possible to delete profiles completely can i switch an agency user to be an employee user instead, so i can assign them different permissions? yes this is usually used when you'd like to provide an agency user with additional access to certain roles (for example, the ability to schedule candidates and view all candidates considered for the role) navigate to admin > organization setup > agencies https //app ashbyhq com/admin/organizational settings/agencies/list select the agency and the agency user in question head to the permissions tab on the user's profile in the agency drop down, click the x beside the agency name this removes the link between the user and the agency the user is automatically given the limited access access role to provide them with a specific access role to a job or department, set them to elevated access, then determine the level of access they should have and the roles, departments, or locations they should have access to for more on this, see user permissions to switch an employee user to an agency user, use the agency dropdown on the user's profile to select an agency and assign it to the user