Create a Position

📘
Position and opening(s)
When making a request to create a new position, you can also define the details for the opening(s) that will be created for the new position. The openings array is optional - if you don't provide any opening details, a single new opening will be created by default.

Request

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

Request body parameters:

Field	Type	Required	Description
name	string	required
status	string	required	One of the following: `open` `on hold` `closed`
is_discreet	boolean	required	`true` means that the position is only visible to teammates on the position's hiring team.
department	string	optional	If the provided value doesn't exist it will be added as a new option
experience_level	string	optional	If the provided value doesn't exist it will be added as a new option
employment_type	string	optional	If the provided value doesn't exist it will be added as a new option
is_talent_pool	boolean	optional	`true` means that this position is a talent pool
location	object	optional
location.uid	string	optional	Location UID
salary_range	object		Position salary range. Permission to write positions salary range is required.
salary_range.min	int
salary_range.max	int
salary_range.currency_code	string		Currency using 3 letters code (ISO 4217)
salary_range.period	string		One of the following: `hourly` `weekly` `monhtly` `annually`
categories	array	optional	Custom categories
categories[].name	string	required for provided categories	Must match an existing field's name
categories[].value	string	required for provided categories	For dropdown fields - a value that doesn't already exist will be added as a dropdown option
details	array	optional	Free-form text details.
details[].name	string	required for provided details	Must match an existing field's name
details[].value	string	required for provided details	HTML
allow_fallback	boolean	optional	Applies when the `email` provided for users doesn't match an existing user in Recruit: When `true` - the earliest Owner of the account is assigned for the role instead of the specified user. When `false`(default) - the request will fail
users	object	required
users.lead_recruiter	object	required
users.lead_recruiter.email	string	required	Email address of an existing user. Must have a company recruiter role.
users.hiring_manager	object	required
users.hiring_manager.email	string	required	Email address of an existing user
users.lead_recruiting_coordinator	object	optional
users.lead_recruiting_coordinator.email	string	optional	Email address of an existing user
openings[]	array	optional
openings[].name	string	required	Opening name
openings[].approval_status	string	optional	One of the following: `APPROVED`
openings[].time_expected_hire	date	required
openings[].reason	string	required	One of the following: `New`, `Replacement hire`, `Temporary replacement`
openings[].status	string	required	Must be `OPEN`
openings[].time_approved	date	optional	Required if the approval status is set to `APPROVED`
openings[].time_opened	date	optional	If empty, the default value is the time of the creation of the opening.
openings[].custom_fields	object	optional	Key-value pairs of custom opening fields. Keys must match a name of an existing custom field. For dropdown fields - a value that doesn't already exist will be added as a dropdown option.
questionnaire_uids	array	optional	questionnaires UIDs

{  
  "name":"Account Executive, Austin",
  "status": "open",
  "is_discreet": false,
  "department":"Sales",
  "employment_type":"Full-time",
  "experience_level":"Intermediate",
  "is_talent_pool": false,          
  "location_uid": "D00.000",
   "salary_range": {
   	"min": 20000,
   	"max": 40000,
   	"currency_code": "USD",
   	"period": "Monthly"
  },
  "questionnaire_uids": ['00.001','00.002','00.003'],
  "categories":[  
    {  
      "name":"Territory",
      "value":"USA"
    },
    {
      "name": "workplace_type",
      "value": "Remote"
    }
    //...
  ],
  "details":[  
    {  
      "name":"Description",
      "value":"We are looking for ..."
    },
    {  
      "name":"Requirements",
      "value":"Candidates should have ..."
    }
    //...
  ],
  "users": {
    "hiring_manager": {
      "email": "[email protected]"
    },
    "lead_recruiter": {
      "email": "[email protected]"
    }
  },
  "openings": [
    {
      "name": "Opening 1",
      "time_expected_hire": "2023-09-17T13:10:59Z",
      "reason": "New",
      "status": "Open",
      "time_opened": "2023-07-19T13:10:59Z"
    },
    {
      "name": "Opening 2",
      "time_approved": "2023-07-01",
      "time_expected_hire": "2023-09-17T13:10:59Z",
      "reason": "New",
      "status": "Open",
      "time_opened": "2023-07-19T13:10:59Z"
    }
  ]
}

Response

Fields that are set to "Internal use" will be omitted from the response.

{  
  "uid":"87.405",
  "name":"Account Executive, Austin",
  "status": "open",
  "is_discreet": false,
  "is_published": true,    
  "department":"Sales",
  "email":"[email protected]",
  "url_recruit_hosted_page":"https://www.comeet.co/jobs/companyname/30.005/account-executive-austin/87.405",
  "url_active_page":"https://www.comeet.co/jobs/companyname/30.005/account-executive-austin/87.405",
  "employment_type":"Full-time",
  "experience_level":"Intermediate",
  "internal_use_custom_id":null,
  "picture_url":"https://comeet-euw-app.s3.amazonaws.com/53/b5ac4af700dfe6d749a862f7ba267f288f6cb575",
  "time_updated":"2017-05-26T14:22:46Z",
  "company_name":"Company Name",
  "position_url":"https://www.comeet.co/careers-api/2.0/company/30.005/positions/87.405?token=359F1DD13E1DD1DD1A813E6A6A",
  "is_talent_pool": false,          
  "location":{  
    "name":"Austin, TX",
    "country":"US",
    "city":"Austin",
    "state":"TX",
    "postal_code":"",
    "street_name":"",
    "arrival_instructions":null,
    "street_number":"",
    "timezone":"America/Iqaluit",
    "uid": "D00.000"
  },
   "salary_range": {
   	"min": 200000,
   	"max": 40000,
   	"currency_code": "USD",
   	"period": "Monthly"
  },
  "categories":[  
    {  
      "name":"Territory",
      "value":"USA",
      "order":1
    },
    {
      "name": "workplace_type",
      "value": "Remote",
      "order":2
    }
    //...
  ],
  "details":[  
    {  
      "name":"Description",
      "value":"We are looking for ...",
      "order":1
    },
    {  
      "name":"Requirements",
      "value":"Candidates should have ...",
      "order":2
    }
    //...
  ],
"openings": [
        {
            "uid": "D0.000",
            "name": "Opening 1",
            "approval_process": null,
            "hired_candidate_uid": null,
            "time_expected_hire": "2023-09-17T13:10:59Z",
            "headcount": 1,
            "reason": "New",
            "status": "Open",
            "time_created": "2023-09-20T22:05:40Z",
            "time_last_status_change": "2023-09-20T22:05:40Z",
            "time_opened": "2023-07-19T13:10:59Z",
            "time_updated": "2023-09-20T22:05:40Z",
            "custom_fields": {}
        },
        {
            "uid": "D0.001",
            "name": "Opening 2",
            "approval_process": null,
            "hired_candidate_uid": null,
            "time_expected_hire": "2023-09-17T13:10:59Z",
            "headcount": 1,
            "reason": "New",
            "status": "Open",
            "time_created": "2023-09-20T22:05:40Z",
            "time_last_status_change": "2023-09-20T22:05:40Z",
            "time_opened": "2023-07-19T13:10:59Z",
            "time_updated": "2023-09-20T22:05:40Z",
            "custom_fields": {}
        }  
}