Create a job

POST 
/v1/jobs

Required scopejobs:writeWhat are scopes?

Creates a job in draft status. To launch it, add a post with Create a job post and then Publish a job.

Request

Responses

201

Job created

401

Missing or invalid bearer token.

403

The public API is not enabled for this account (err_feature_not_enabled), the acting user is not allowed to create jobs, or the API key lacks the jobs:write scope (err_insufficient_scope).

422

Validation failed. Error codes:

• err_department_not_found — unknown or deleted department
• err_office_not_found — unknown or deleted office
• err_invalid_employment_type — unknown or disabled employment type key
• err_description_required — no description or template, or the description is empty
• err_description_too_long — the description is over 65,535 bytes
• err_description_conflict — both description and job_description_template_id were sent
• err_job_description_template_not_found — unknown template, or one this job can't use
• err_compensation_required — no salary while compensation is enabled for the job's offices
• err_compensation_disabled — a salary was sent while compensation is not enabled for the job's offices
• err_currency_not_found — unknown currency
• err_salary_invalid_range — max_amount is not above min_amount, or mid_amount is outside the range
• err_requisitions_not_enabled — requisitions are not enabled for your account
• err_requisition_required — your account requires a requisition and none was sent
• err_requisition_not_found — unknown requisition, or one the acting user can't manage
• err_requisition_not_eligible — the requisition's status doesn't allow linking
• err_requisition_associated_with_job — the requisition is already linked to another job
• err_requisition_code_not_allowed — requisition_code was sent while requisitions are on (use requisition_ids)
• err_requisition_code_required — the job form makes the requisition ID mandatory and none was sent
• err_job_profile_not_found — job profiles are not enabled, or the profile is unknown or not active
• err_job_profile_required — your account requires a job profile and none was sent
• err_custom_field_not_found — a custom field that doesn't apply to this job
• err_custom_field_required — a required custom field has no answer
• err_on_behalf_of_not_allowed — a personal access token passed another user's ID
• err_user_not_found — on_behalf_of is not an active user in the account
• err_on_behalf_of_forbidden — that user is not allowed to perform this action