---
title: "Creates a job post"
method: POST
path: "/api/v1/job/posts"
tags: ["Job::Posts"]
---

# Creates a job post

`POST /api/v1/job/posts`

## Request

- Base URL: `https://api.flexiple.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.flexiple.com/api/v1/job/posts`
- Auth: HTTP bearer

## Request body

- object
  - `designation` string
  - `requirement` string
  - `intake_flow` 'fast' | 'detailed'
  - `new_company_id` integer
  - `is_internal` boolean

## Response `201`

Created

- object
  - `data` JobPost, required
    - `id` integer, required
    - `client_id` integer
    - `new_company_id` integer
    - `job_slug` string, nullable, required
    - `designation` string, nullable, required
    - `location_type` 'remote' | 'on_site' | 'hybrid' | 'null', nullable, required
    - `status` 'private' | 'published' | 'closed', required
    - `job_type` 'contract' | 'full_time' | 'any', required
    - `published_at` string, date-time, nullable, required
    - `company_name` string
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `assignment_ids` string[], nullable
    - `hide_budget` boolean
    - `is_internal` boolean
    - `client_share_tag` string
    - `start_salary` object
      - `amount` number, required
      - `currency` string, required
      - `display_scale` number, required
      - `display_unit` string, required
      - `formatted_amount` number, required
      - `formatted` string, required
    - `end_salary` object
      - `amount` number, required
      - `currency` string, required
      - `display_scale` number, required
      - `display_unit` string, required
      - `formatted_amount` number, required
      - `formatted` string, required
    - `location` Location
      - `id` integer, required
      - `osm_id` integer, nullable, required
      - `osm_type` string, nullable, required
      - `city` string, nullable, required
      - `state` string, nullable, required
      - `country` string, nullable, required
      - `country_code` string, nullable, required
      - `formatted` string, required
      - `location_type` 'country' | 'state' | 'city', required
  - `meta` object, nullable
    - `intake_run_id` string

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden

---

[API](https://skmtc.dev/flexiple/apis/flexiple-platform-api-v1.md) - [All operations](https://skmtc.dev/flexiple/apis/flexiple-platform-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/flexiple/apis/flexiple-platform-api-v1/revisions/27e7987859f2?raw)