Users
Create user
Getting Started
Endpoints
- Applications
- Candidates
- Jobs
- Feedback
- Interviews
- Users
- Files
- Settings
- Webhooks
Webhooks
Users
Create user
Create a new user
POST
/
v1.0
/
{company_id}
/
users
curl --request POST \
--url https://api.hirehive.com/v1.0/{company_id}/users \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"first_name": "<string>",
"last_name": "<string>",
"email": "jsmith@example.com",
"type": "primary_admin",
"category": {
"id": "<string>",
"name": "<string>"
},
"permissions": [
"<string>"
],
"reviewer_statuses": [
{
"parent_stage": "rejected",
"custom_stage": {
"id": "<string>",
"name": "<string>"
}
}
],
"linked_user_candidates": [
{
"user_id": "<string>",
"candidate_id": "<string>",
"full_name": "<string>",
"email": "<string>"
}
]
}'
{
"data": {
"id": "<string>",
"first_name": "<string>",
"last_name": "<string>",
"email": "<string>",
"assigned_job_ids": [
"<string>"
],
"type": "primary_admin",
"category": {
"id": "<string>",
"name": "<string>"
},
"permissions": [
"<string>"
],
"reviewer_statuses": [
{
"parent_stage": "rejected",
"custom_stage": {
"id": "<string>",
"name": "<string>"
}
}
],
"linked_user_candidates": [
{
"user_id": "<string>",
"candidate_id": "<string>",
"full_name": "<string>",
"email": "<string>"
}
]
}
}
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Path Parameters
Body
application/json
Maximum length:
100
Maximum length:
100
Maximum length:
100
Available options:
primary_admin
, admin
, user
, recruiter
, reviewer
Available options: MANAGE_TEAM
, SETTINGS_BILLING
, SETTINGS_JOBBOARD
, RESTRICTED_ACCESS
, EXPORT_REPORTS
, MANAGE_JOBS
, JOB_PUBLISH
, MESSAGE_CANDIDATE
, SETTINGS_JOBBOARD
The parent stage of the application. eg Screening
, Interviewing
Available options:
rejected
, new
, screening
, interviewing
, offered
, hired
Response
201
application/json
Available options:
primary_admin
, admin
, user
, recruiter
, reviewer
Available options: MANAGE_TEAM
, SETTINGS_BILLING
, SETTINGS_JOBBOARD
, RESTRICTED_ACCESS
, EXPORT_REPORTS
, MANAGE_JOBS
, JOB_PUBLISH
, MESSAGE_CANDIDATE
The parent stage of the application. eg Screening
, Interviewing
Available options:
rejected
, new
, screening
, interviewing
, offered
, hired
Was this page helpful?
curl --request POST \
--url https://api.hirehive.com/v1.0/{company_id}/users \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"first_name": "<string>",
"last_name": "<string>",
"email": "jsmith@example.com",
"type": "primary_admin",
"category": {
"id": "<string>",
"name": "<string>"
},
"permissions": [
"<string>"
],
"reviewer_statuses": [
{
"parent_stage": "rejected",
"custom_stage": {
"id": "<string>",
"name": "<string>"
}
}
],
"linked_user_candidates": [
{
"user_id": "<string>",
"candidate_id": "<string>",
"full_name": "<string>",
"email": "<string>"
}
]
}'
{
"data": {
"id": "<string>",
"first_name": "<string>",
"last_name": "<string>",
"email": "<string>",
"assigned_job_ids": [
"<string>"
],
"type": "primary_admin",
"category": {
"id": "<string>",
"name": "<string>"
},
"permissions": [
"<string>"
],
"reviewer_statuses": [
{
"parent_stage": "rejected",
"custom_stage": {
"id": "<string>",
"name": "<string>"
}
}
],
"linked_user_candidates": [
{
"user_id": "<string>",
"candidate_id": "<string>",
"full_name": "<string>",
"email": "<string>"
}
]
}
}