Team & roles
Invite teammates, import your team from a CSV, change roles, grant extra capabilities, set up delegation, read the audit log and remove members.
Organization Admins manage who is in your InsightHire workspace and what they can do. Everything on this page lives under Settings → People:
- Access groups: the team list, invitations, role changes and removals.
- Roles & access: the default access model and extra capabilities for specific people.
- Invitations: every pending and sent invitation.
For what each role can do, see Roles & permissions.
Who can do what
| Task | Who |
|---|---|
| Invite, import, edit or remove team members | Organization Admins |
| Change the default access model and grant extra capabilities | Organization Admins |
| Set up delegation for someone else | Organization Admins |
| Set up your own delegates | Anyone, from Account |
| View and export the audit log | Organization Admins, and anyone granted Auditor |
Invite a teammate
- Open Settings → People → Access groups.
- Select Invite Member.
- Enter the person's email address, first name and last name.
- Choose their Hire access: Organization Admin, Hiring Manager, Recruiter or No Hire access (Grow only).
- Choose their Grow access: No Grow access, Grow manager or Grow admin. It starts at Grow admin for Organization Admins and No Grow access for Hiring Managers. Recruiters can't have Grow access. With No Hire access, pick Grow manager or Grow admin; the person then sees only Grow.
- Select Send Invitation.
The person gets an email invitation. They sign in with a magic link, an emailed code, a passkey or your company single sign-on. There is no password to create. See Sign in.
Invitations expire after 7 days. Resend an expired invitation before the person can use it.
If your organization uses approvals and intake forms, inviting a Hiring Manager also offers Also send a hiring request kickoff. Completing the kickoff form creates a separate draft job.
Import the team from a CSV
- Open Settings → People → Access groups (or Org Structure → People).
- Select Import team, then Download template.
- Fill in
email,first_name,last_name,role,department_path,location,titleandmanager_email. The role must be Organization Admin, Hiring Manager or Recruiter. The optionalgrow_accesscolumn takesNONE,MANAGERorADMIN. Leave it blank to use the role's default for new people and keep the current level for existing people. Recruiters can't have Grow access. - Upload the file and fix any row errors shown in the preview.
- Confirm the import.
The same email is never invited twice. Missing departments and locations are created only after you confirm. See Org Structure.
Resend or cancel an invitation
- Open Settings → People → Access groups.
- Find the person. Pending invitations show a pending status, and Last Login shows Never.
- Open the actions menu and select Resend invite, or select Remove to cancel the invitation.
Settings → People → Invitations shows the same invitations in one list.
Change someone's role or name
- Open Settings → People → Access groups.
- Open the actions menu for the person and select Edit access.
- Correct the name if needed, choose their Hire access (Organization Admin, Hiring Manager, Recruiter or No Hire access) and their Grow access. If your organization has custom roles, they're listed under Your custom roles. The dialog opens on their current role, and saving only a name change never changes the role.
- Select Save member.
Custom roles
Custom roles let you build your own roles, like "Coordinator" or "Department head", and choose exactly which jobs people see and what they can do. They are an optional feature: InsightHire support turns them on for your organization. Until then, the section says custom roles are off.
Create a custom role
- Open Settings → People → Roles & access and find Custom roles.
- Select New role and give it a name. A description is optional.
- Under Which jobs they see, pick one:
- Same as recruiters: the jobs your default access model gives recruiters.
- Only their own jobs: jobs they manage, are on the hiring team for, or interview for. This applies to the jobs list, search, pipeline and reports.
- Every job: every job in your organization.
- Specific jobs: only the departments, locations or jobs you pick. Pick at least one.
- Under What they can do, tick the boxes. They're grouped into Hiring, Settings, and Reports, pay and records. Start from: Recruiter or Hiring manager ticks the same boxes that role has, as a starting point.
- Select Create role.
Managing roles and billing always stay with Organization Admins, so nobody can give themselves more access.
Give someone a custom role
- Open Settings → People → Access groups.
- Open the actions menu for the person and select Edit access.
- Under Your custom roles, choose the role and select Save member.
The custom role replaces their Recruiter or Hiring Manager role. They can do only what the role's boxes allow, on only the jobs it sees. The team list shows the role's name. To move them back, choose a built-in role in the same dialog. Custom roles can't be given to Organization Admins. Change them to another role first.
Change or deactivate a custom role
Select Edit next to the role to rename it, change which jobs it sees or change its boxes. Changes apply to everyone with the role straight away. Deactivate is available once nobody has the role. Give those people another role first.
If InsightHire turns custom roles off for your organization, everyone goes back to the built-in role underneath (Recruiter, or Hiring Manager for Only their own jobs). Your roles are kept for if it's turned back on.
Creating, changing and assigning custom roles is recorded in the audit log.
Change someone's Grow access
The Grow access column on the team list changes it in one step: No Grow access, Grow manager (their reporting line) or Grow admin (everyone). For a Hiring Manager without Grow, the actions menu also offers Also make Grow manager. Recruiters can't have Grow access. The change shows in that person's menu the next time they return to the app.
Extra access
Sometimes a person needs one narrow capability, not a bigger role. Extra access adds that capability on top of their team role. It never removes anything they can already do.
Extra access is for organizations without custom roles. When custom roles are on, these sections are hidden. Build a custom role with the boxes you need instead.
| Grant | What it adds |
|---|---|
| Auditor | View and export the audit log |
| Billing viewer | Read-only view of the account's subscription and invoices |
| Sensitive field viewer | See custom fields an admin marked sensitive |
| Position viewer (scoped) | Read-only access to jobs and their pipelines |
| Report viewer | Dashboards, analytics and saved reports for the jobs they can see |
| Report builder | Build, save, schedule and share reports, alerts and data feeds |
| Report admin | Reports across every job, and managing other people's reports, schedules, alerts and feeds |
| Pay viewer | See pay bands, offer amounts and job pay ranges. Can be restricted to jobs, departments or locations. |
| Pay manager | See pay for every job, and edit pay bands |
By default Recruiters are report builders and see pay, and Hiring Managers are report viewers without pay. A grant is only needed to give one person more. See Custom reports.
What each role can do
What each role can do on Settings → People → Roles & access sets the defaults for everyone with a team role in your organization: seeing and building reports, report admin, seeing pay, editing pay bands, the audit log, sensitive fields and every job.
- Tick or untick the boxes for Recruiter, Hiring manager or Grow only.
- Select Save. The change applies straight away.
Reset to defaults puts every role back to the InsightHire defaults. The Org admin column can't be changed: Organization Admins always have everything, so nobody can lock your organization out. Extra access still adds on top of these defaults. A custom role uses its own boxes instead. Changes are recorded in the audit log. See What each role can do by default.
Give extra access
- Open Settings → People → Roles & access.
- Under Give extra access, search for the person by name or email and select them.
- Choose the role.
- For Position viewer (scoped), you can tick Restrict this grant to specific jobs, departments, or locations and pick at least one. Leave it unticked for read access to every job.
- Select Grant.
It works straight away. It shows under People with extra access, marked Org-wide or with the jobs, departments or locations it is restricted to.
Remove extra access
- Open Settings → People → Roles & access.
- Find the person under People with extra access.
- Select Revoke and confirm.
Granting and revoking are recorded in the audit log.
Default access model
The top of Settings → People → Roles & access sets which jobs people see by default: FLAT or GRANULAR, with an optional department limit. See Which jobs you can see.
Delegation
A delegate can act on someone's behalf. They see and do everything that person can, and every action is recorded under the delegate's own name.
- To set up your own delegates, open Account from the account menu and use Delegation.
- An Organization Admin can set up delegates for someone else: on Settings → People → Access groups, open the person's actions menu and select Manage delegation.
The delegate then sees Act as in their account menu. While acting as someone, a banner shows whose seat they are in, with Switch back.
The audit log
Open Settings → Security and select View audit log.
The audit log records every change made in your organization (who, what, when, and the result) and every time someone opens, downloads or exports candidate personal data, including your API keys and the assistant. Support access by InsightHire staff shows up here too.
- Use the filters at the top: Who, What, Type (changes or reads), Result, Candidate ID and dates.
- Select Export CSV to download what you filtered.
- Select Verify integrity to check that no entry was removed or altered. The check reports a clean chain, or the first entry where it breaks.
- Open a candidate and look for Who accessed this record in the side panel to see everyone who opened, exported or changed that person.
Entries can't be edited or deleted. They are kept for 7 years by default. Under Retention an Organization Admin can lengthen that, never shorten it. When a candidate is erased on request, their entries stay but the personal details in them are removed.
Organization Admins can see it. So can anyone granted Auditor.
Remove a member
- Open Settings → People → Access groups.
- Open the person's actions menu and select Remove.
- Confirm with Remove Member.
Removing someone ends their access to your workspace. Their past scorecards, messages, approvals and audit history stay. You can't remove yourself.
If your organization uses directory sync (SCIM), people deactivated in your identity provider lose access automatically. See Single sign-on & SCIM.
Troubleshooting
- An invitation did not arrive: ask the person to check spam, then resend it. Also check your sending domain in Settings → Communications → Email settings.
- The person sees Access Denied: check that their role allows the page. Most settings are for Organization Admins only.
- Last Login shows Never: the person has not signed in yet.
- Single sign-on sends people back to the sign-in page: check the setup on Settings → Security, or contact InsightHire support.
Related
Job Levels & Pay Bands
Set up job levels and employment types, load pay bands from a CSV, and see how jobs and offers pick a band.
Single sign-on & SCIM
Connect your identity provider so your team signs in with their company account, keep the team list in sync, map groups to roles and require single sign-on.
