Create an Opening

Create an Opening.

Request

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

Request body parameters:

FieldTypeRequiredDescription
position_uidstringrequired
namestringrequiredOpening name
approval_statusstringoptionalOne of the following:
APPROVED
time_expected_hiredaterequired
reasonstringrequiredOne of the following:
New,
Replacement hire,
Temporary replacement
statusstringrequiredThe status value should be OPEN
time_approveddateoptionalRequired if the approval status is set to APPROVED
time_openeddateoptionalIf empty, the default value is the request date and time.
custom_fieldsobjectoptionalKey-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"
    }
}