Create a Position

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:

FieldTypeRequiredDescription
namestringrequired
statusstringrequiredOne of the following:
open
on hold
closed
is_discreetbooleanrequiredtrue means that the position is only visible to teammates on the position's hiring team.
departmentstringoptionalIf the provided value doesn't exist it will be added as a new option
experience_levelstringoptionalIf the provided value doesn't exist it will be added as a new option
employment_typestringoptionalIf the provided value doesn't exist it will be added as a new option
is_talent_poolbooleanoptionaltrue means that this position is a talent pool
locationobjectoptional
location.uidstringoptionalLocation UID
salary_rangeobjectPosition salary range. Permission to write positions salary range is required.
salary_range.minint
salary_range.maxint
salary_range.currency_codestringCurrency using 3 letters code (ISO 4217)
salary_range.periodstringOne of the following:
hourly
weekly
monhtly
annually
categoriesarrayoptionalCustom categories
categories[].namestringrequired for provided categoriesMust match an existing field's name
categories[].valuestringrequired for provided categoriesFor dropdown fields - a value that doesn't already exist will be added as a dropdown option
detailsarrayoptionalFree-form text details.
details[].namestringrequired for provided detailsMust match an existing field's name
details[].valuestringrequired for provided detailsHTML
allow_fallbackbooleanoptionalApplies when the email provided for users doesn't match an existing user in Comeet:
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
usersobjectrequired
users.lead_recruiterobjectrequired
users.lead_recruiter.emailstringrequiredEmail address of an existing user. Must have a company recruiter role.
users.hiring_managerobjectrequired
users.hiring_manager.emailstringrequiredEmail address of an existing user
users.recruiting_coordinatorobjectoptional
users.recruiting_coordinator.emailstringoptionalEmail address of an existing user
openings[]arrayoptional
openings[].namestringrequiredOpening name
openings[].approval_statusstringoptionalOne of the following:
APPROVED
openings[].time_expected_hiredaterequired
openings[].reasonstringrequiredOne of the following:
New,
Replacement hire,
Temporary replacement
openings[].statusstringrequiredMust be OPEN
openings[].time_approveddateoptionalRequired if the approval status is set to APPROVED
openings[].time_openeddateoptionalIf empty, the default value is the time of the creation of the opening.
openings[].custom_fieldsobjectoptionalKey-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.
{  
  "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": 200000,
   	"max": 40000,
   	"currency_code": "USD",
   	"period": "Monthly"
  },
  "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_comeet_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": {}
        }  
}