Create Job

POST/AtsJob/create

Creates a new job listing. The contact email is automatically taken from the authenticated account. The job is immediately published (Activated); if the active job limit is exceeded, it becomes Deactivated.

Request Body

FieldTypeRequiredDescription
titlestringrequiredJob title. Max 20 characters
regionstringrequiredJob region/city
descriptionstringrequiredJob description. Min 100 characters. Excess HTML tags are auto-removed
addressstringoptionalStreet address
salaryValue1decimal?optionalSalary from. Whole number, ≥ 0
salaryValue2decimal?optionalSalary to. Whole number, ≥ 0, must be ≥ salaryValue1
salaryRateIdsbyte?optionalSalary rate. One of 0, 1, 2, 3, 5 (see Enums). Required if salaryValue1 is set
jobType1sbyte?optionalEmployment type. 0=Any, 1=Full-time, 2=Temporary, 3=Part-time, 4=Internship, 5=Remote (see Enums)
jobType2sbyte?optionalSecondary employment type (same values as jobType1)

Validation Rules

  • title is required, max 20 characters.
  • description is required, min 100 characters (HTML is auto-simplified).
  • region is required.
  • salaryValue1 / salaryValue2, if set, must be whole numbers ≥ 0.
  • salaryValue2 cannot be set without salaryValue1; if both are provided, salaryValue2 must be ≥ salaryValue1.
  • salaryRateId is required when salaryValue1 is set, and must be one of 0, 1, 2, 3, 5.
  • jobType1 / jobType2, if set, must be a valid employment type (0–5).
  • jobType2 cannot be set without jobType1.

Errors

StatusDescription
400 Bad RequestValidation error, or subscription is pending approval (SubscriptionOnApproving)
403 ForbiddenAccount does not belong to the authenticated employer

Request

curl -X POST https://ua.jooble.org/employer/api/v2/AtsJob/create \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
  -d '{
    "title": "Backend Developer",
    "region": "Kyiv",
    "address": "Khreshchatyk 22",
    "salaryValue1": 2000,
    "salaryValue2": 3500,
    "salaryRateId": 1,
    "description": "We are looking for an experienced ASP.NET developer ...",
    "jobType1": 0,
    "jobType2": 4
  }'

Response · 200 OK

{
  "id": 12345,
  "dateCreated": "2025-01-20T12:10:00Z"
}