---
title: "/offers"
method: POST
path: "/c/{company_id}/offers"
---

# /offers

`POST /c/{company_id}/offers`

Create a company offer (job or talent pool).

Watch out when testing the endpoint here! It will create new resources!

## Path parameters

- `company_id` integer, required

## Headers

- `Content-Type` string

## Request body

- object
  - `offer` object
    - `title` string, required — Offer title
    - `kind` string — Possible values: job, talent_pool.
    - `location_ids` integer[], required — Offer locations IDs - taken from the /locations endpoint
    - `description` string, required — Offer description
    - `requirements` string, required — Offer requirements. Optional for `kind: talent_pool`
    - `department_id` string — Offer department - if you provide an existing department ID, the offer will be assigned to the department
    - `on_site` boolean — 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` boolean — If true, shows offer's location as hybrid on careers site.
    - `remote` boolean — 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.
    - `visibility_options` string[] — Enables the option to add a location picker to the application form
    - `locations_question` string — Content of the question for the location picker
    - `locations_question_type` string — `single_choice` for a single location, `multiple_choice` for multiple locations
    - `locations_question_required` boolean — If true, preferred location needs to be selected from the location picker

## Response `200`

200

- object
  - `offer` object
    - `remote` boolean
    - `qualifiedCandidatesCount` integer
    - `guid` string
    - `title` string
    - `fieldsetId` integer
    - `followers` object[]
      - `email` string
      - `firstName` string
      - `hasAvatar` boolean
      - `id` integer
      - `initials` string
      - `lastName` string
      - `photoNormalUrl` string
      - `photoThumbUrl` string
      - `timeFormat24` boolean
      - `timezone` string
    - `offerTags` unknown[]
      - unknown
    - `pipelineTemplate` object
      - `category` unknown
      - `custom` boolean
      - `default` boolean
      - `id` integer
      - `position` unknown
      - `stages` object[]
        - `actionTemplates` unknown[]
          - unknown
        - `category` string
        - `fairEvaluationsEnabled` boolean
        - `id` integer
        - `locked` boolean
        - `name` string
        - `placementsCount` integer
        - `position` integer
        - `timeLimit` unknown
      - `title` string
    - `notesCount` integer
    - `id` integer
    - `visibilityOptions` string[]
    - `openQuestionTemplateId` unknown
    - `countryCode` string
    - `status` string
    - `followed` boolean
    - `jobScheduler` unknown
    - `category` string
    - `disqualifiedCandidatesCount` integer
    - `optionsCoverLetter` string
    - `url` string
    - `hasActiveCampaign` boolean
    - `optionsPhone` string
    - `primaryLangCode` string
    - `city` string
    - `employmentType` string
    - `street` unknown
    - `salary` object
      - `currency` unknown
      - `max` unknown
      - `min` unknown
      - `period` unknown
    - `eeoSettings` unknown
    - `careersUrl` string
    - `emailConfirmation` boolean
    - `sharingImage` unknown
    - `maxHours` unknown
    - `admins` object[]
      - `email` string
      - `firstName` string
      - `hasAvatar` boolean
      - `id` integer
      - `initials` string
      - `lastName` string
      - `membership` object
        - `adminId` integer
        - `id` integer
        - `offerIds` integer[]
        - `quickStartSteps` object
          - `adjustNotifications` boolean
          - `automatedActions` boolean
          - `careersSiteCustomize` boolean
          - `careersSiteDescription` boolean
          - `createJob` boolean
          - `enableEeo` boolean
          - `enableGdpr` boolean
          - `enableSso` boolean
          - `featurePack` boolean
          - `hiringRoles` boolean
          - `importCandidates` boolean
          - `installMobileApp` boolean
          - `integrations` boolean
          - `introVideo` boolean
          - `inviteTeamMembers` boolean
          - `jobDescription` boolean
          - `mobileAppDescription` boolean
          - `navigationTour` boolean
          - `pipelineOverview` boolean
          - `plan` boolean
          - `promoteJobs` boolean
          - `publishJobs` boolean
          - `sourceCandidates` boolean
          - `sourcingExtension` boolean
          - `syncCalendar` boolean
          - `talentPools` boolean
        - `role` string
        - `roleAdmin` boolean
        - `roleId` integer
        - `showAcademyButton` boolean
        - `twoFactorAuthEnabled` boolean
      - `photoNormalUrl` string
      - `photoThumbUrl` string
      - `roleAbilities` string[]
      - `roleAdmin` boolean
      - `roleId` integer
      - `roleName` string
      - `timeFormat24` boolean
      - `timezone` string
    - `sharingTitle` unknown
    - `sharingDescription` unknown
    - `location` string
    - `enabledForReferrals` boolean
    - `closedAt` unknown
    - `updatedAt` string
    - `fieldset` object
      - `default` boolean
      - `fields` object[]
        - `id` integer
        - `kind` string
        - `name` unknown
        - `options` object
        - `visibility` object
          - `adminIds` unknown[]
            - unknown
          - `level` string
          - `roleIds` unknown[]
            - unknown
        - `visible` boolean
      - `id` integer
      - `name` string
    - `education` string
    - `hasAdditionalInfo` boolean
    - `example` boolean
    - `recruiterId` unknown
    - `optionsPhoto` string
    - `department` unknown
    - `requirements` string
    - `emailConfirmationSubject` string
    - `minHours` unknown
    - `experience` string
    - `createdAt` string
    - `fields` unknown[]
      - unknown
    - `defaultTranslations` object
      - `emailConfirmationBody` string
      - `emailConfirmationSubject` string
      - `title` string
    - `position` integer
    - `attachmentsCount` integer
    - `departmentId` unknown
    - `hiringManagerId` unknown
    - `adminappUrl` string
    - `description` string
    - `autoReplyTemplateId` integer
    - `langCode` string
    - `kind` string
    - `pipeline` boolean
    - `postalCode` unknown
    - `pipelineTemplateId` integer
    - `candidatesCount` integer
    - `stateCode` string
    - `slug` string
    - `optionsCv` string
    - `mailboxEmail` string
    - `emailConfirmationBody` string
    - `publishedAt` string

## Other responses

- `401` — 401
- `404` — 404

---

[API](https://skmtc.net/recruitee/apis/careers-site-api.md) · [All operations](https://skmtc.net/recruitee/apis/careers-site-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/recruitee/careers-site-api/revisions/e9fbe3c5466d/schema)