---
updatedAt: 2025-06-09T23:12:25.000Z
---
Fetch the complete documentation index at: https://docs.recruitee.com/llms.txt. Use this file to discover all available pages before exploring further. Append .md to any documentation page URL to get its markdown version.
# /offers
Create a company offer (job or talent pool).
Watch out when testing the endpoint here! It will create new resources!
## Selected offer fields in response
|
Field name
|
Description
|
|
**position**
|
Position of the offer in the web app.
|
|
**status**
|
Status of the job. Possible values: draft, internal, published, closed, archived
|
|
**followed**
|
True if token owner follows the offer
|
|
**title**
|
Offer title
|
|
**slug**
|
Parameterized title of the offer, used in offer URLs
|
|
**kind**
|
Type of the offer. Can be `job` or `talent_pool`
|
# OpenAPI definition
```json
{
"openapi": "3.1.0",
"info": {
"title": "ats-api",
"version": "1.0"
},
"servers": [
{
"url": "https://api.recruitee.com"
}
],
"components": {
"securitySchemes": {
"sec0": {
"type": "oauth2",
"flows": {}
}
}
},
"security": [
{
"sec0": []
}
],
"paths": {
"/c/{company_id}/offers": {
"post": {
"summary": "/offers",
"description": "Create a company offer (job or talent pool).\n\nWatch out when testing the endpoint here! It will create new resources!",
"operationId": "offersid-post",
"parameters": [
{
"name": "company_id",
"in": "path",
"description": "Company ID. A company subdomain can also be used.",
"schema": {
"type": "integer",
"format": "int32"
},
"required": true
},
{
"name": "Content-Type",
"in": "header",
"schema": {
"type": "string",
"default": "application/json"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"offer": {
"properties": {
"title": {
"type": "string",
"description": "Offer title"
},
"kind": {
"type": "string",
"description": "Possible values: job, talent_pool.",
"default": "job"
},
"location_ids": {
"type": "array",
"description": "Offer locations IDs - taken from the /locations endpoint",
"items": {
"type": "integer",
"format": "int32"
}
},
"description": {
"type": "string",
"description": "Offer description"
},
"requirements": {
"type": "string",
"description": "Offer requirements. Optional for `kind: talent_pool`"
},
"department_id": {
"type": "string",
"description": "Offer department - if you provide an existing department ID, the offer will be assigned to the department"
},
"on_site": {
"type": "boolean",
"description": "If true, shows offer's location as on-site on careers site. Note: for \"work_model\" fields `on_site` `hybrid` or `remote` at least one needs to be `true`"
},
"hybrid": {
"type": "boolean",
"description": "If true, shows offer's location as hybrid on careers site."
},
"remote": {
"type": "boolean",
"description": "If true, shows offer's location as remote on careers site. Note: even with `remote: true`, you need to provide the location details, as some job boards require that.",
"default": false
},
"visibility_options": {
"type": "array",
"description": "Enables the option to add a location picker to the application form",
"default": [
"locations_question"
],
"items": {
"type": "string"
}
},
"locations_question": {
"type": "string",
"description": "Content of the question for the location picker",
"default": "What is your preferred location?"
},
"locations_question_type": {
"type": "string",
"description": "`single_choice` for a single location, `multiple_choice` for multiple locations",
"default": "single_choice"
},
"locations_question_required": {
"type": "boolean",
"description": "If true, preferred location needs to be selected from the location picker"
}
},
"required": [
"title",
"location_ids",
"description",
"requirements"
],
"type": "object"
}
}
}
}
}
},
"responses": {
"200": {
"description": "200",
"content": {
"application/json": {
"examples": {
"OK": {
"value": "{\n \"offer\": {\n \"remote\": false,\n \"qualifiedCandidatesCount\": 0,\n \"guid\": \"6bl4y\",\n \"title\": \"Senior Product Designer\",\n \"fieldsetId\": 160356,\n \"followers\": [\n {\n \"email\": \"john.smith@recruitee.com\",\n \"firstName\": \"John\",\n \"hasAvatar\": true,\n \"id\": 21775,\n \"initials\": \"JS\",\n \"lastName\": \"Smith\",\n \"photoNormalUrl\": \"https://recruitee.s3.eu-central-1.amazonaws.com/admins/21775/normal_avatar_vt5hln3m8r5k.jpg\",\n \"photoThumbUrl\": \"https://recruitee.s3.eu-central-1.amazonaws.com/admins/21775/thumb_avatar_vt5hln3m8r5k.jpg\",\n \"timeFormat24\": true,\n \"timezone\": \"America/Chicago\"\n }\n ],\n \"offerTags\": [],\n \"pipelineTemplate\": {\n \"category\": null,\n \"custom\": false,\n \"default\": true,\n \"id\": 178088,\n \"position\": null,\n \"stages\": [\n {\n \"actionTemplates\": [],\n \"category\": \"referred\",\n \"fairEvaluationsEnabled\": false,\n \"id\": 2212021,\n \"locked\": true,\n \"name\": \"Referred\",\n \"placementsCount\": 0,\n \"position\": -3,\n \"timeLimit\": null\n },\n {\n \"actionTemplates\": [],\n \"category\": \"sourced\",\n \"fairEvaluationsEnabled\": false,\n \"id\": 2212022,\n \"locked\": true,\n \"name\": \"Sourced\",\n \"placementsCount\": 0,\n \"position\": -2,\n \"timeLimit\": null\n },\n {\n \"actionTemplates\": [],\n \"category\": \"apply\",\n \"fairEvaluationsEnabled\": false,\n \"id\": 2212023,\n \"locked\": true,\n \"name\": \"Applied\",\n \"placementsCount\": 0,\n \"position\": -1,\n \"timeLimit\": null\n },\n {\n \"actionTemplates\": [],\n \"category\": \"phone_screen\",\n \"fairEvaluationsEnabled\": false,\n \"id\": 2212024,\n \"locked\": false,\n \"name\": \"Phone interview\",\n \"placementsCount\": 0,\n \"position\": 1,\n \"timeLimit\": null\n },\n {\n \"actionTemplates\": [],\n \"category\": \"interview\",\n \"fairEvaluationsEnabled\": false,\n \"id\": 2212025,\n \"locked\": false,\n \"name\": \"On-site interview\",\n \"placementsCount\": 0,\n \"position\": 2,\n \"timeLimit\": null\n },\n {\n \"actionTemplates\": [],\n \"category\": \"evaluation\",\n \"fairEvaluationsEnabled\": false,\n \"id\": 2212026,\n \"locked\": false,\n \"name\": \"Evaluation\",\n \"placementsCount\": 0,\n \"position\": 3,\n \"timeLimit\": null\n },\n {\n \"actionTemplates\": [],\n \"category\": \"offer\",\n \"fairEvaluationsEnabled\": false,\n \"id\": 2212027,\n \"locked\": false,\n \"name\": \"Offer\",\n \"placementsCount\": 0,\n \"position\": 4,\n \"timeLimit\": null\n },\n {\n \"actionTemplates\": [],\n \"category\": \"hire\",\n \"fairEvaluationsEnabled\": false,\n \"id\": 2212028,\n \"locked\": false,\n \"name\": \"Hired\",\n \"placementsCount\": 0,\n \"position\": 5,\n \"timeLimit\": null\n }\n ],\n \"title\": \"Default\"\n },\n \"notesCount\": 0,\n \"id\": 567441,\n \"visibilityOptions\": [\n \"linkedin\",\n \"indeed\",\n \"social_share\",\n \"job_location\"\n ],\n \"openQuestionTemplateId\": null,\n \"countryCode\": \"DE\",\n \"status\": \"published\",\n \"followed\": true,\n \"jobScheduler\": null,\n \"category\": \"design\",\n \"disqualifiedCandidatesCount\": 0,\n \"optionsCoverLetter\": \"optional\",\n \"url\": \"https://apiacademy.recruitee.com/o/senior-product-designer\",\n \"hasActiveCampaign\": false,\n \"optionsPhone\": \"required\",\n \"primaryLangCode\": \"en\",\n \"city\": \"Berlin\",\n \"employmentType\": \"fulltime\",\n \"street\": null,\n \"salary\": {\n \"currency\": null,\n \"max\": null,\n \"min\": null,\n \"period\": null\n },\n \"eeoSettings\": null,\n \"careersUrl\": \"https://apiacademy.recruitee.com/o/senior-product-designer\",\n \"emailConfirmation\": true,\n \"sharingImage\": null,\n \"maxHours\": null,\n \"admins\": [\n {\n \"email\": \"john.smith@recruitee.com\",\n \"firstName\": \"John\",\n \"hasAvatar\": true,\n \"id\": 21775,\n \"initials\": \"JS\",\n \"lastName\": \"Smith\",\n \"membership\": {\n \"adminId\": 21775,\n \"id\": 439276,\n \"offerIds\": [\n 433214,\n 433773,\n 433774,\n 433775,\n 433776,\n 433777,\n 433778,\n 433779,\n 433780,\n 436667,\n 471560,\n 471567,\n 567441\n ],\n \"quickStartSteps\": {\n \"adjustNotifications\": false,\n \"automatedActions\": false,\n \"careersSiteCustomize\": false,\n \"careersSiteDescription\": false,\n \"createJob\": true,\n \"enableEeo\": false,\n \"enableGdpr\": false,\n \"enableSso\": false,\n \"featurePack\": false,\n \"hiringRoles\": false,\n \"importCandidates\": false,\n \"installMobileApp\": false,\n \"integrations\": false,\n \"introVideo\": false,\n \"inviteTeamMembers\": false,\n \"jobDescription\": false,\n \"mobileAppDescription\": false,\n \"navigationTour\": false,\n \"pipelineOverview\": false,\n \"plan\": false,\n \"promoteJobs\": false,\n \"publishJobs\": false,\n \"sourceCandidates\": false,\n \"sourcingExtension\": false,\n \"syncCalendar\": false,\n \"talentPools\": true\n },\n \"role\": \"Administrator\",\n \"roleAdmin\": true,\n \"roleId\": 901817,\n \"showAcademyButton\": true,\n \"twoFactorAuthEnabled\": false\n },\n \"photoNormalUrl\": \"https://recruitee.s3.eu-central-1.amazonaws.com/admins/21775/normal_avatar_vt5hln3m8r5k.jpg\",\n \"photoThumbUrl\": \"https://recruitee.s3.eu-central-1.amazonaws.com/admins/21775/thumb_avatar_vt5hln3m8r5k.jpg\",\n \"roleAbilities\": [\n \"manage_attributes\",\n \"manage_disqualify_reasons\",\n \"send_emails\",\n \"schedule_events\",\n \"manage_job_widget\",\n \"view_promote_section\",\n \"view_interview_reports\",\n \"manage_company\",\n \"view_calendar_section\",\n \"view_mailbox_section\",\n \"manage_webhooks\",\n \"manage_automated_actions\",\n \"premium_job_boards\",\n \"high_level_data_access\",\n \"manage_referral_templates\",\n \"manage_email_integrations\",\n \"manage_interview_templates\",\n \"manage_pipeline_templates\",\n \"manage_jobs_referral_settings\",\n \"manage_profile_fields_templates\",\n \"view_candidates_section\",\n \"manage_recruiters\",\n \"manage_open_questions\",\n \"manage_referrals\",\n \"view_members_reports\",\n \"manage_subscription\",\n \"manage_api_tokens\",\n \"manage_open_questions_templates\",\n \"manage_report_dashboards\",\n \"manage_jobs\",\n \"manage_candidate\",\n \"manage_email_templates\",\n \"view_report_dashboards\",\n \"view_all_jobs\",\n \"free_job_boards\",\n \"assign_users_to_jobs\",\n \"manage_integrations\",\n \"view_reports_section\",\n \"export_data\",\n \"edit_career_site\",\n \"delete_candidates\",\n \"share_candidates\",\n \"publish_jobs\",\n \"view_jobs_section\",\n \"manage_profile_fields\",\n \"gdpr\",\n \"manage_job_boards_credentials\",\n \"review_hidden_evaluations\"\n ],\n \"roleAdmin\": true,\n \"roleId\": 901817,\n \"roleName\": \"Administrator\",\n \"timeFormat24\": true,\n \"timezone\": \"America/Chicago\"\n }\n ],\n \"sharingTitle\": null,\n \"sharingDescription\": null,\n \"location\": \"Berlin, Germany\",\n \"enabledForReferrals\": false,\n \"closedAt\": null,\n \"updatedAt\": \"2022-04-08T10:28:51.799410Z\",\n \"fieldset\": {\n \"default\": true,\n \"fields\": [\n {\n \"id\": 644835,\n \"kind\": \"language_skill\",\n \"name\": null,\n \"options\": {},\n \"visibility\": {\n \"adminIds\": [],\n \"level\": \"public\",\n \"roleIds\": []\n },\n \"visible\": true\n },\n {\n \"id\": 644836,\n \"kind\": \"skills\",\n \"name\": null,\n \"options\": {},\n \"visibility\": {\n \"adminIds\": [],\n \"level\": \"public\",\n \"roleIds\": []\n },\n \"visible\": true\n }\n ],\n \"id\": 160356,\n \"name\": \"Basic\"\n },\n \"education\": \"master_degree\",\n \"hasAdditionalInfo\": true,\n \"example\": false,\n \"recruiterId\": null,\n \"optionsPhoto\": \"optional\",\n \"department\": null,\n \"requirements\": \"Five years of experience in product design.
\",\n \"emailConfirmationSubject\": \"[job_offer] - Confirmation of your application\",\n \"minHours\": null,\n \"experience\": \"experienced\",\n \"createdAt\": \"2022-04-08T10:28:51.799410Z\",\n \"fields\": [],\n \"defaultTranslations\": {\n \"emailConfirmationBody\": \"Your application for the [job_offer] position has been successfully submitted.
If you want to add something to your application just respond to this email.
[company]\",\n \"emailConfirmationSubject\": \"[job_offer] - Confirmation of your application\",\n \"title\": \"Senior Product Designer\"\n },\n \"position\": 10,\n \"attachmentsCount\": 0,\n \"departmentId\": null,\n \"hiringManagerId\": null,\n \"adminappUrl\": \"https://app.recruitee.com/#/offers/senior-product-designer\",\n \"description\": \"We would like to hire a Senior Product Designer.
\",\n \"autoReplyTemplateId\": 163754,\n \"langCode\": \"en\",\n \"kind\": \"job\",\n \"pipeline\": false,\n \"postalCode\": null,\n \"pipelineTemplateId\": 178088,\n \"candidatesCount\": 0,\n \"stateCode\": \"BE\",\n \"slug\": \"senior-product-designer\",\n \"optionsCv\": \"required\",\n \"mailboxEmail\": \"job.6bl4y@apiacademy.recruitee.com\",\n \"emailConfirmationBody\": \"Your application for the [job_offer] position has been successfully submitted.
If you want to add something to your application just respond to this email.
[company]\",\n \"publishedAt\": \"2022-04-08T10:28:51.740080Z\"\n }\n}"
}
},
"schema": {
"type": "object",
"properties": {
"offer": {
"type": "object",
"properties": {
"remote": {
"type": "boolean",
"example": false,
"default": true
},
"qualifiedCandidatesCount": {
"type": "integer",
"example": 0,
"default": 0
},
"guid": {
"type": "string",
"example": "6bl4y"
},
"title": {
"type": "string",
"example": "Senior Product Designer"
},
"fieldsetId": {
"type": "integer",
"example": 160356,
"default": 0
},
"followers": {
"type": "array",
"items": {
"type": "object",
"properties": {
"email": {
"type": "string",
"example": "john.smith@recruitee.com"
},
"firstName": {
"type": "string",
"example": "John"
},
"hasAvatar": {
"type": "boolean",
"example": true,
"default": true
},
"id": {
"type": "integer",
"example": 21775,
"default": 0
},
"initials": {
"type": "string",
"example": "JS"
},
"lastName": {
"type": "string",
"example": "Smith"
},
"photoNormalUrl": {
"type": "string",
"example": "https://recruitee.s3.eu-central-1.amazonaws.com/admins/21775/normal_avatar_vt5hln3m8r5k.jpg"
},
"photoThumbUrl": {
"type": "string",
"example": "https://recruitee.s3.eu-central-1.amazonaws.com/admins/21775/thumb_avatar_vt5hln3m8r5k.jpg"
},
"timeFormat24": {
"type": "boolean",
"example": true,
"default": true
},
"timezone": {
"type": "string",
"example": "America/Chicago"
}
}
}
},
"offerTags": {
"type": "array"
},
"pipelineTemplate": {
"type": "object",
"properties": {
"category": {},
"custom": {
"type": "boolean",
"example": false,
"default": true
},
"default": {
"type": "boolean",
"example": true,
"default": true
},
"id": {
"type": "integer",
"example": 178088,
"default": 0
},
"position": {},
"stages": {
"type": "array",
"items": {
"type": "object",
"properties": {
"actionTemplates": {
"type": "array"
},
"category": {
"type": "string",
"example": "referred"
},
"fairEvaluationsEnabled": {
"type": "boolean",
"example": false,
"default": true
},
"id": {
"type": "integer",
"example": 2212021,
"default": 0
},
"locked": {
"type": "boolean",
"example": true,
"default": true
},
"name": {
"type": "string",
"example": "Referred"
},
"placementsCount": {
"type": "integer",
"example": 0,
"default": 0
},
"position": {
"type": "integer",
"example": -3,
"default": 0
},
"timeLimit": {}
}
}
},
"title": {
"type": "string",
"example": "Default"
}
}
},
"notesCount": {
"type": "integer",
"example": 0,
"default": 0
},
"id": {
"type": "integer",
"example": 567441,
"default": 0
},
"visibilityOptions": {
"type": "array",
"items": {
"type": "string",
"example": "linkedin"
}
},
"openQuestionTemplateId": {},
"countryCode": {
"type": "string",
"example": "DE"
},
"status": {
"type": "string",
"example": "published"
},
"followed": {
"type": "boolean",
"example": true,
"default": true
},
"jobScheduler": {},
"category": {
"type": "string",
"example": "design"
},
"disqualifiedCandidatesCount": {
"type": "integer",
"example": 0,
"default": 0
},
"optionsCoverLetter": {
"type": "string",
"example": "optional"
},
"url": {
"type": "string",
"example": "https://apiacademy.recruitee.com/o/senior-product-designer"
},
"hasActiveCampaign": {
"type": "boolean",
"example": false,
"default": true
},
"optionsPhone": {
"type": "string",
"example": "required"
},
"primaryLangCode": {
"type": "string",
"example": "en"
},
"city": {
"type": "string",
"example": "Berlin"
},
"employmentType": {
"type": "string",
"example": "fulltime"
},
"street": {},
"salary": {
"type": "object",
"properties": {
"currency": {},
"max": {},
"min": {},
"period": {}
}
},
"eeoSettings": {},
"careersUrl": {
"type": "string",
"example": "https://apiacademy.recruitee.com/o/senior-product-designer"
},
"emailConfirmation": {
"type": "boolean",
"example": true,
"default": true
},
"sharingImage": {},
"maxHours": {},
"admins": {
"type": "array",
"items": {
"type": "object",
"properties": {
"email": {
"type": "string",
"example": "john.smith@recruitee.com"
},
"firstName": {
"type": "string",
"example": "John"
},
"hasAvatar": {
"type": "boolean",
"example": true,
"default": true
},
"id": {
"type": "integer",
"example": 21775,
"default": 0
},
"initials": {
"type": "string",
"example": "JS"
},
"lastName": {
"type": "string",
"example": "Smith"
},
"membership": {
"type": "object",
"properties": {
"adminId": {
"type": "integer",
"example": 21775,
"default": 0
},
"id": {
"type": "integer",
"example": 439276,
"default": 0
},
"offerIds": {
"type": "array",
"items": {
"type": "integer",
"example": 433214,
"default": 0
}
},
"quickStartSteps": {
"type": "object",
"properties": {
"adjustNotifications": {
"type": "boolean",
"example": false,
"default": true
},
"automatedActions": {
"type": "boolean",
"example": false,
"default": true
},
"careersSiteCustomize": {
"type": "boolean",
"example": false,
"default": true
},
"careersSiteDescription": {
"type": "boolean",
"example": false,
"default": true
},
"createJob": {
"type": "boolean",
"example": true,
"default": true
},
"enableEeo": {
"type": "boolean",
"example": false,
"default": true
},
"enableGdpr": {
"type": "boolean",
"example": false,
"default": true
},
"enableSso": {
"type": "boolean",
"example": false,
"default": true
},
"featurePack": {
"type": "boolean",
"example": false,
"default": true
},
"hiringRoles": {
"type": "boolean",
"example": false,
"default": true
},
"importCandidates": {
"type": "boolean",
"example": false,
"default": true
},
"installMobileApp": {
"type": "boolean",
"example": false,
"default": true
},
"integrations": {
"type": "boolean",
"example": false,
"default": true
},
"introVideo": {
"type": "boolean",
"example": false,
"default": true
},
"inviteTeamMembers": {
"type": "boolean",
"example": false,
"default": true
},
"jobDescription": {
"type": "boolean",
"example": false,
"default": true
},
"mobileAppDescription": {
"type": "boolean",
"example": false,
"default": true
},
"navigationTour": {
"type": "boolean",
"example": false,
"default": true
},
"pipelineOverview": {
"type": "boolean",
"example": false,
"default": true
},
"plan": {
"type": "boolean",
"example": false,
"default": true
},
"promoteJobs": {
"type": "boolean",
"example": false,
"default": true
},
"publishJobs": {
"type": "boolean",
"example": false,
"default": true
},
"sourceCandidates": {
"type": "boolean",
"example": false,
"default": true
},
"sourcingExtension": {
"type": "boolean",
"example": false,
"default": true
},
"syncCalendar": {
"type": "boolean",
"example": false,
"default": true
},
"talentPools": {
"type": "boolean",
"example": true,
"default": true
}
}
},
"role": {
"type": "string",
"example": "Administrator"
},
"roleAdmin": {
"type": "boolean",
"example": true,
"default": true
},
"roleId": {
"type": "integer",
"example": 901817,
"default": 0
},
"showAcademyButton": {
"type": "boolean",
"example": true,
"default": true
},
"twoFactorAuthEnabled": {
"type": "boolean",
"example": false,
"default": true
}
}
},
"photoNormalUrl": {
"type": "string",
"example": "https://recruitee.s3.eu-central-1.amazonaws.com/admins/21775/normal_avatar_vt5hln3m8r5k.jpg"
},
"photoThumbUrl": {
"type": "string",
"example": "https://recruitee.s3.eu-central-1.amazonaws.com/admins/21775/thumb_avatar_vt5hln3m8r5k.jpg"
},
"roleAbilities": {
"type": "array",
"items": {
"type": "string",
"example": "manage_attributes"
}
},
"roleAdmin": {
"type": "boolean",
"example": true,
"default": true
},
"roleId": {
"type": "integer",
"example": 901817,
"default": 0
},
"roleName": {
"type": "string",
"example": "Administrator"
},
"timeFormat24": {
"type": "boolean",
"example": true,
"default": true
},
"timezone": {
"type": "string",
"example": "America/Chicago"
}
}
}
},
"sharingTitle": {},
"sharingDescription": {},
"location": {
"type": "string",
"example": "Berlin, Germany"
},
"enabledForReferrals": {
"type": "boolean",
"example": false,
"default": true
},
"closedAt": {},
"updatedAt": {
"type": "string",
"example": "2022-04-08T10:28:51.799410Z"
},
"fieldset": {
"type": "object",
"properties": {
"default": {
"type": "boolean",
"example": true,
"default": true
},
"fields": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"example": 644835,
"default": 0
},
"kind": {
"type": "string",
"example": "language_skill"
},
"name": {},
"options": {
"type": "object",
"properties": {}
},
"visibility": {
"type": "object",
"properties": {
"adminIds": {
"type": "array"
},
"level": {
"type": "string",
"example": "public"
},
"roleIds": {
"type": "array"
}
}
},
"visible": {
"type": "boolean",
"example": true,
"default": true
}
}
}
},
"id": {
"type": "integer",
"example": 160356,
"default": 0
},
"name": {
"type": "string",
"example": "Basic"
}
}
},
"education": {
"type": "string",
"example": "master_degree"
},
"hasAdditionalInfo": {
"type": "boolean",
"example": true,
"default": true
},
"example": {
"type": "boolean",
"example": false,
"default": true
},
"recruiterId": {},
"optionsPhoto": {
"type": "string",
"example": "optional"
},
"department": {},
"requirements": {
"type": "string",
"example": "Five years of experience in product design.
"
},
"emailConfirmationSubject": {
"type": "string",
"example": "[job_offer] - Confirmation of your application"
},
"minHours": {},
"experience": {
"type": "string",
"example": "experienced"
},
"createdAt": {
"type": "string",
"example": "2022-04-08T10:28:51.799410Z"
},
"fields": {
"type": "array"
},
"defaultTranslations": {
"type": "object",
"properties": {
"emailConfirmationBody": {
"type": "string",
"example": "Your application for the [job_offer] position has been successfully submitted.
If you want to add something to your application just respond to this email.
[company]"
},
"emailConfirmationSubject": {
"type": "string",
"example": "[job_offer] - Confirmation of your application"
},
"title": {
"type": "string",
"example": "Senior Product Designer"
}
}
},
"position": {
"type": "integer",
"example": 10,
"default": 0
},
"attachmentsCount": {
"type": "integer",
"example": 0,
"default": 0
},
"departmentId": {},
"hiringManagerId": {},
"adminappUrl": {
"type": "string",
"example": "https://app.recruitee.com/#/offers/senior-product-designer"
},
"description": {
"type": "string",
"example": "We would like to hire a Senior Product Designer.
"
},
"autoReplyTemplateId": {
"type": "integer",
"example": 163754,
"default": 0
},
"langCode": {
"type": "string",
"example": "en"
},
"kind": {
"type": "string",
"example": "job"
},
"pipeline": {
"type": "boolean",
"example": false,
"default": true
},
"postalCode": {},
"pipelineTemplateId": {
"type": "integer",
"example": 178088,
"default": 0
},
"candidatesCount": {
"type": "integer",
"example": 0,
"default": 0
},
"stateCode": {
"type": "string",
"example": "BE"
},
"slug": {
"type": "string",
"example": "senior-product-designer"
},
"optionsCv": {
"type": "string",
"example": "required"
},
"mailboxEmail": {
"type": "string",
"example": "job.6bl4y@apiacademy.recruitee.com"
},
"emailConfirmationBody": {
"type": "string",
"example": "Your application for the [job_offer] position has been successfully submitted.
If you want to add something to your application just respond to this email.
[company]"
},
"publishedAt": {
"type": "string",
"example": "2022-04-08T10:28:51.740080Z"
}
}
}
}
}
}
}
},
"401": {
"description": "401",
"content": {
"application/json": {
"examples": {
"Result": {
"value": "{\n \"error\": \"Resource access requires authentication!\",\n \"errorCode\": null\n}"
}
},
"schema": {
"type": "object",
"properties": {
"error": {
"type": "string",
"example": "Resource access requires authentication!"
},
"errorCode": {}
}
}
}
}
},
"404": {
"description": "404",
"content": {
"text/plain": {
"examples": {
"Result": {
"value": "{\n \"error\": [\n \"Page not found\"\n ]\n}"
}
},
"schema": {
"type": "object",
"properties": {
"error": {
"type": "array",
"items": {
"type": "string",
"example": "Page not found"
}
}
}
}
}
}
}
},
"deprecated": false,
"x-readme": {
"code-samples": [
{
"language": "curl",
"code": "curl -X POST \\\n https://api.recruitee.com/c/{company_id}/offers \\\n -H 'Authorization: Bearer {token}' \\\n -H 'content-type: application/json' \\\n -d '{\n \"offer\": {\n \"title\": \"Frontend Developers\",\n \"department_id\": \"{department_id}\",\n \"description\": \"We would like to hire some Frontend devs
\",\n \"kind\": \"talent_pool\"\n }\n}'",
"name": "Create talent pool"
}
],
"samples-languages": [
"curl"
]
}
}
}
},
"x-readme": {
"headers": [],
"explorer-enabled": true,
"proxy-enabled": true
},
"x-readme-fauxas": true
}
```