Create an Opening

Request

POST https://api.comeet.co/openings/

Request body parameters:

Field	Type	Required	Description
position_uid	string	required
name	string	required	Opening name
approval_status	string	optional	One of the following: `APPROVED`
time_expected_hire	date	required
reason	string	required	One of the following: `New`, `Replacement hire`, `Temporary replacement`
status	string	required	The status value should be `OPEN`
time_approved	date	optional	Required if the approval status is set to `APPROVED`
time_opened	date	optional	If empty, the default value is the request date and time.
custom_fields	object	optional	Key-value pairs of custom opening fields. Keys must match an existing custom field's name. For dropdown fields - a value that doesn't already exist will be added as a dropdown option

        {
            "position_uid": "3A.93C",
            "time_expected_hire": "2022-03-09T07:55:40Z",
            "name": "New Opening #1",
            "reason": "Replacement hire",
            "approval_status": "APPROVED",
            "time_approved": "2022-01-08T07:55:40Z",
            "custom_fields": {
                "Department": "Marketing"
            }
        }

Response

{
    "uid": "0F.96B",
    "position_uid": "3A.93C",
    "name": "New Opening #1",
    "approval_process": {
        "uid": "32.06A",
        "name": "Approval process for opening",
        "time_started": "2022-01-08T07:55:40Z",
        "time_completed": "2022-01-08T07:55:40Z",
        "status": "APPROVED"
    },
    "hired_candidate_uid": null,
    "time_expected_hire": "2022-03-09T07:55:40Z",
    "headcount": 1,
    "reason": "Replacement hire",
    "status": "Open",
    "time_created": "2023-09-13T13:56:42Z",
    "time_last_status_change": "2023-09-13T13:56:42Z",
    "time_opened": "2023-09-13T13:56:42Z",
    "time_updated": "2023-09-13T13:56:42Z",
    "custom_fields": {
        "Department": "Marketing"
    }
}