---
title: "Create a new job post"
method: POST
path: "/jobs"
tags: ["Job Posts"]
---

# Create a new job post

`POST /jobs`

## Request

- Base URL: `https://staging.api-golang.boilerplate.hng.tech/api/v1`
- URL: `https://staging.api-golang.boilerplate.hng.tech/api/v1/jobs`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/hngprojects/apis/kimiko-golang-swagger/docs/jobs/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates a new job post with the provided details.

## Request body

- CreateJobPost
  - `title` string
  - `salary_range` string
  - `job_type` string
  - `location` string
  - `deadline` string
  - `job_mode` string
  - `experience_level` string
  - `benefits` string
  - `company_name` string
  - `description` string
  - `key_responsibilities` string
  - `qualifications` string

## Response `201`

Job post created successfully

- JobPostResponse
  - `status` string
  - `status_code` integer
  - `message` string
  - `data` JobPost
    - `id` string
    - `title` string
    - `salary_range` string
    - `job_type` string
    - `location` string
    - `deadline` string, date-time
    - `job_mode` string
    - `experience_level` string
    - `how_to_apply` string
    - `benefits` string
    - `company_name` string
    - `description` string
    - `key_responsibilities` string
    - `qualifications` string
    - `created_at` string, date-time
    - `updated_at` string, date-time

## Other responses

- `400`: Invalid input
- `500`: Failed to create job post

## Changes

- **2024-08-08** `0e62b1539f9c`: 9 warning, 8 info
  - removed the request property `experience`
  - removed the request property `how_to_apply`
  - removed the request property `job_benefits`
  - removed the request property `salary`
  - …13 more
- **2024-08-07** `06cecc2ac126`: 8 warning, 9 info
  - removed the request property `benefits`
  - removed the request property `experience_level`
  - removed the request property `job_mode`
  - removed the request property `salary_range`
  - …13 more

[Operation history](https://skmtc.dev/hngprojects/apis/kimiko-golang-swagger/changes/jobs/post.md)

---

[API](https://skmtc.dev/hngprojects/apis/kimiko-golang-swagger.md) - [All operations](https://skmtc.dev/hngprojects/apis/kimiko-golang-swagger/llms.txt) - [OpenAPI document](https://skmtc.dev/hngprojects/apis/kimiko-golang-swagger/revisions/2d1d3ed96bb9?raw)