Hiring Team
Abstract
The Hiring Team endpoints provide access to user management across different organizational levels within the ATS. These endpoints allow you to retrieve lists of users and their roles at the company, job, and application levels. Each endpoint returns paginated results containing user details including email addresses, names, agency status, and role assignments. Authentication is required via X-App-Id and X-App-Key headers.
- Company-levelCompany-level hiring team
- Job-levelJob-level hiring team
- Application-levelApplication-level hiring team
User Object
Name | Type | Description |
|---|---|---|
email_primary | string (email) | Primary email address |
emails | array of string | All verified email addresses |
first_name | string | User's first name |
id | Integer | Unique user ID |
is_agency_user | boolean | Whether the user belongs to an agency |
last_name | string | User's last name |
role | string | User's role in the application |
User Roles
UserRole object can return one of these roles.
Name | Description |
|---|---|
owner | Owner of the company |
admin | Administrator of the company |
manager | Manager of the company |
member | Member of the company |
collaborator | Collaborator on the job |
viewer | Viewer of the job |
job_owner | Owner of the job |
job_interviewer | Interviewer on the job |
application_interviewer | Interviewer of the application |