v1

latestOpenAPI 3.1.02026-07-261770816.7 KB

Job Owners

Create job owner

Add a user to a job's hiring team as a recruiter, sourcer, or coordinator. The user must already exist in your organization and have permission to edit the job. For recruiter and coordinator, pass candidate_responsibility to make this user the responsible owner for active, inactive, future, or all candidates on the job — omitting it leaves new applications without a responsible recruiter or coordinator. This is the V3 replacement for the V1 POST /v1/jobs/{id}/hiring_team flow for these three roles; hiring managers are assigned via POST /v3/job_hiring_managers. To remove a user from the hiring team, call DELETE /v3/job_owners/{id} with the row id returned here.

post/v3/job_owners

Request body

job_idinteger required

Id of the job to assign the user to. Must belong to your organization.

user_idinteger required

Id of the user to add to the hiring team. The user must already exist in your organization and have permission to edit the job.

type'sourcer' | 'recruiter' | 'coordinator' required

Hiring-team role to assign. One of sourcer, recruiter, or coordinator. To assign a hiring manager instead, use POST /v3/job_hiring_managers.

candidate_responsibility'active' | 'inactive' | 'future' | 'all'

For recruiter and coordinator only, which existing and future candidates on the job this user becomes the responsible owner for: active (in-process), inactive (rejected and hired), future (new applications only), or all. Ignored for sourcer. If omitted for a recruiter or coordinator, no existing or future candidates are assigned to the user, which can leave new applications without a responsible recruiter — pass all to match the legacy V1 POST /v1/jobs/{id}/hiring_team behavior.

Response

Successful

idinteger

created_atstring date-time

updated_atstring date-time

job_idinteger

Id of the job this hiring-team assignment belongs to. References a /v3/jobs row.

user_idinteger

Id of the user assigned to the job in this role. References a /v3/users row. The same user can hold multiple roles on the same job; each role is a separate row.

type'sourcer' | 'recruiter' | 'coordinator'

Hiring-team role this user holds on the job. One of sourcer, recruiter, or coordinator. Hiring managers are exposed on the separate /v3/job_hiring_managers endpoint.

responsibleboolean

If true, this user is the responsible recruiter or coordinator for the job — the default assignee for new applications created against this job. Always false for sourcer rows, which do not carry candidate responsibility.