> ## Documentation Index > Fetch the complete documentation index at: https://api-docs.spott.io/llms.txt > Use this file to discover all available pages before exploring further. # Create a job > Creates a new job. Requires a company ID and job details such as status, title, and description. ## OpenAPI ````yaml /openapi-private.json post /vacancies openapi: 3.1.0 info: title: Spott API Reference version: '0.1' servers: - url: https://api.gospott.com security: [] tags: [] paths: /vacancies: post: tags: - Jobs summary: Create a job description: >- Creates a new job. Requires a company ID and job details such as status, title, and description. operationId: createVacancy parameters: [] requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CreateVacancyDto' responses: '201': description: Job created successfully. Returns the job ID. content: application/json: schema: $ref: '#/components/schemas/CreateRecordResponseDto' '400': description: Bad request - missing or invalid required fields content: application/json: schema: allOf: - $ref: '#/components/schemas/ExceptionBaseDto' - type: object properties: statusCode: type: number example: 400 message: type: string example: Company ID is required for creating a job error: type: string example: Bad Request '401': description: Unauthorized - invalid or missing authentication content: application/json: schema: $ref: '#/components/schemas/ExceptionBaseDto' '500': description: Error response content: application/json: schema: $ref: '#/components/schemas/ExceptionBaseDto' security: - x-api-key: [] components: schemas: CreateVacancyDto: type: object properties: companyId: type: string minLength: 1 name: type: string minLength: 1 description: anyOf: - type: string - type: 'null' stageId: type: string minLength: 1 salaryRange: anyOf: - $ref: '#/components/schemas/CreateVacancySalaryRangeDto' - type: 'null' location: anyOf: - $ref: '#/components/schemas/CreateLocationDto' - type: 'null' deprecated: true description: >- Deprecated: use `locations` instead. A single physical location for the job. Ignored when `locations` is provided. locations: description: >- Physical locations for the job (0 to 15). Takes precedence over the deprecated `location` field. maxItems: 15 type: array items: $ref: '#/components/schemas/CreateLocationDto' languages: description: Languages required for the job (0 to 100). maxItems: 100 type: array items: $ref: '#/components/schemas/CreateVacancyLanguageDto' employmentType: anyOf: - type: string enum: - fullTime - partTime - temporary - internship - permanent - fixedTermContract - interimOrTemporary - contract - type: 'null' locationType: anyOf: - type: string enum: - remote - hybrid - onsite - type: 'null' restricted: type: boolean startAt: anyOf: - $ref: '#/components/schemas/DateISO' - type: 'null' endAt: anyOf: - $ref: '#/components/schemas/DateISO' - type: 'null' teamUserIds: type: array items: type: string minLength: 1 clientContactIds: type: array items: type: string minLength: 1 targetCompanyId: anyOf: - type: string minLength: 1 - type: 'null' required: - companyId - name - description - stageId - salaryRange - location - employmentType - locationType - startAt - endAt - teamUserIds - clientContactIds - targetCompanyId id: PrivateCreateVacancyDto CreateRecordResponseDto: type: object properties: id: type: string minLength: 1 required: - id id: CreateRecordResponseDto ExceptionBaseDto: type: object properties: status: type: integer minimum: -9007199254740991 maximum: 9007199254740991 message: type: string requestId: type: string required: - status - message - requestId id: ExceptionBaseDto CreateVacancySalaryRangeDto: type: object properties: min: anyOf: - type: number - type: 'null' max: anyOf: - type: number - type: 'null' currency: $ref: '#/components/schemas/DmCurrency' required: - min - max - currency id: PrivateCreateVacancySalaryRangeDto CreateLocationDto: type: object properties: street1: anyOf: - type: string - type: 'null' street2: anyOf: - type: string - type: 'null' postalCode: anyOf: - type: string - type: 'null' city: anyOf: - type: string - type: 'null' region: anyOf: - type: string - type: 'null' state: anyOf: - type: string - type: 'null' country: anyOf: - type: string - type: 'null' latitude: anyOf: - type: number - type: 'null' longitude: anyOf: - type: number - type: 'null' type: anyOf: - $ref: '#/components/schemas/LocationType' - type: 'null' required: - street1 - street2 - postalCode - city - region - state - country - type id: PrivateCreateLocationDto CreateVacancyLanguageDto: type: object properties: language: $ref: '#/components/schemas/DmLanguageEnum' fluency: $ref: '#/components/schemas/DmFluencyEnum' required: - language - fluency id: PrivateCreateVacancyLanguageDto DateISO: id: DateISO format: date-time anyOf: - type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ - type: string format: date pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$ DmCurrency: type: string enum: - AED - AFN - ALL - AMD - ANG - AOA - ARS - AUD - AWG - AZN - BAM - BBD - BDT - BGN - BHD - BIF - BMD - BND - BOB - BRL - BSD - BTC - BTN - BWP - BYN - BZD - CAD - CDF - CHF - CLF - CLP - CNH - CNY - COP - CRC - CUC - CUP - CVE - CZK - DJF - DKK - DOP - DZD - EGP - ERN - ETB - EUR - FJD - FKP - GBP - GEL - GGP - GHS - GIP - GMD - GNF - GTQ - GYD - HKD - HNL - HRK - HTG - HUF - IDR - ILS - IMP - INR - IQD - IRR - ISK - JEP - JMD - JOD - JPY - KES - KGS - KHR - KMF - KPW - KRW - KWD - KYD - KZT - LAK - LBP - LKR - LRD - LSL - LYD - MAD - MDL - MGA - MKD - MMK - MNT - MOP - MRU - MUR - MVR - MWK - MXN - MYR - MZN - NAD - NGN - NIO - NOK - NPR - NZD - OMR - PAB - PEN - PGK - PHP - PKR - PLN - PYG - QAR - RON - RSD - RUB - RWF - SAR - SBD - SCR - SDG - SEK - SGD - SHP - SLE - SLL - SOS - SRD - SSP - STD - STN - SVC - SYP - SZL - THB - TJS - TMT - TND - TOP - TRY - TTD - TWD - TZS - UAH - UGX - USD - UYU - UZS - VEF - VES - VND - VUV - WST - XAF - XAG - XAU - XCD - XCG - XDR - XOF - XPD - XPF - XPT - YER - ZAR - ZMW - ZWG - ZWL id: DmCurrency LocationType: type: string enum: - primary_home - secondary_home - primary_work - headquarters - regional_office id: LocationType DmLanguageEnum: type: string enum: - Afrikaans - Albanian - Amharic - Arabic - Armenian - Assamese - Aymara - Azerbaijani - Bangla - Basque - Belarusian - Bemba - Berber - Bislama - Bosnian - Bulgarian - Burman - Catalan - Chechen - Chewa - Chinese (Mandarin) - Chinese (Cantonese) - Chittagonian - Croatian - Czech - Danish - Dari - Dhivehi - Dutch - Dzongkha - English - Estonian - Ewe - Fijian - Filipino - Finnish - French - Galician - Georgian - German - Greek - Guarani - Gujarati - Haitian Creole - Hausa - Hebrew - Hindi - Hungarian - Icelandic - Igbo - Indonesian - Irish - Italian - Japanese - Kannada - Kazakh - Khmer - Kinyarwanda - Kirundi - Korean - Kurdish - Kyrgyz - Lao - Latvian - Lingala - Lithuanian - Luganda - Luxembourgish - Macedonian - Malagasy - Malay - Malayalam - Maltese - Maori - Marathi - Moldovan - Mongolian - Montenegrin - Ndebele - Nepali - Norwegian - Odia - Oromo - Pashto - Persian - Polish - Portuguese - Punjabi - Quechua - Romanian - Russian - Samoan - Sango - Serbian - Sesotho - Setswana - Shona - Sindhi - Sinhala - Slovak - Slovenian - Somali - Spanish - Swahili - Swedish - Tajik - Tamil - Telugu - Tetum - Thai - Tigrinya - Tok Pisin - Tongan - Tsonga - Tswana - Turkish - Turkmen - Ukrainian - Urdu - Uzbek - Venda - Vietnamese - Welsh - Xhosa - Yoruba - Zulu id: DmLanguageEnum DmFluencyEnum: type: string enum: - Elementary proficiency - Limited working proficiency - Professional working proficiency - Full professional proficiency - Native or bilingual proficiency id: DmFluencyEnum securitySchemes: x-api-key: type: apiKey name: x-api-key in: header description: >- API key for authentication. Get your API key from Settings → API Keys in your Spott dashboard. ````