User GuideReference DocumentsChangelog
Reference Documents
Contact Us

Create / Update vacancy

Creates or updates a vacancy. For create, do not specify the Id property. Updates require the id property (id of the vacancy to update)

POST https://api.simplify.hr/v1/Vacancies/Post

Headers:
Content-Type: application/json
Authorization: {token}

Result codes

403 Forbidden
200 Ok (Candidate update)
201 Created (candidate create)
400 Bad request
500 Internal server error

Post json data

Wrap Vacancy fields for list of fields under VacancyInfo property.

{
VacancyInfo : { Vacancy fields }
}

Vacancy Status Ids

All the stages associated with the Vacancy-Id will be returned and will have the following fields:

Vacancy Status IdValue
Draft1
Published2
Closed3
Archived4
PublishedInternal8

See Vacancy Properties for list of fields.

Sample post

{
    "VacancyInfo": {
        "CreatedById": 106,
        "JobTitle": "C# Developer",
        "InternalJobCode": "CDSLDEV3",
        "Description": "Software Development house in the galaxy is looking for an exceptionally intelligent C# .Net Developer to join their brilliant team.",
        "EmploymentTypeId": 1,
        "ExperienceLevelId": 5,
        "IndustryId": 63,
        "FunctionalAreaId": 15,
        "CurrencyId": 1,
        "SalaryMin": 300000,
        "SalaryMax": 350000,
        "EmploymentEquity": false,
        "Disability": false,
        "CountryId": 1,
        "CityId": 362,
        "ProvinceId": 3,
        "Address3": "7000",
        "Telecommute": false,
        "InternalSalaryMin": 350000,
        "InternalSalaryMax": 380000,
        "InternalNotes": "Consideration will be given to candidates with other Object-Oriented coding experience.",
        "VacancyStatusId": 2,
        "DaysOpen": 0,
        "DepartmentId": 11,
        "DepartmentName": "sales",
        "SendToFreeJobsBoards": true,
        "JobGradeId":null,
        "JobGradeName":"",
        "PublishInternal": true,
        "PublishInternalStartDate" : "2023-06-03",
        "PublishInternalSchedule":"2023-08-02",
        "PostDate" : "2023-05-02",
       	"ClosedDate" : "2023-10-02",
    }
}

📘

Create action response

When a new vacancy is created, the API responds with a header containing the URL location for the new vacancy.

e.g. location →https://api.simplify.hr/v1/Vacancies/{id}