---
title: "Record where a job was posted"
method: POST
path: "/openings/{opening_id}/postings"
tags: ["opening"]
---

# Record where a job was posted

`POST /openings/{opening_id}/postings`

## Request

- Base URL: `https://localhost:4410/api/v1`
- URL: `https://localhost:4410/api/v1/openings/{opening_id}/postings`
- Auth: HTTP bearer

Records that a member posted the job on a board, such as LinkedIn, so its page says who posted it there and when. Binderwork posts nowhere itself.

## Path parameters

- `opening_id` string, required

## Request body

- object
  - `board` 'linkedin' | 'indeed' | 'wellfound' | 'workatastartup', required

## Response `200`

The result.

- object
  - `id` string, required
  - `public_id` string, required
  - `status` 'draft' | 'open' | 'closed', required
  - `title` string, required
  - `location` object, required
    - `kind` 'on_site' | 'hybrid' | 'remote', required
    - `place` object, nullable, required
      - `city` string, required
      - `region` string, nullable, required
      - `country` string, required
    - `remote_region` string, nullable, required
  - `employment_type` 'full_time' | 'part_time' | 'contract' | 'internship' | 'temporary', required
  - `pay` object, nullable, required
    - `min` string, required
    - `max` string, required
    - `currency` string, required
    - `period` 'year' | 'hour', required
  - `no_range` object, nullable, required
    - `reason` string, required
    - `by` string, required
    - `at` string, date-time, required
  - `benefits` string, required
  - `url` string, required
  - `counts` object, required
    - `applied` integer, required
    - `screen` integer, required
    - `interview` integer, required
    - `offer` integer, required
    - `hired` integer, required
    - `rejected` integer, required
  - `published_at` string, date-time, nullable, required
  - `closed_at` string, date-time, nullable, required
  - `created_at` string, date-time, required
  - `description` string, required
  - `description_source` 'typed' | 'outline' | 'ai_draft', required
  - `description_provenance` object, nullable, required
    - `model` string, required
    - `accepted_by` string, required
    - `accepted_at` string, date-time, required
  - `equity_note` string, nullable, required
  - `questions` object[], required
    - `id` string, required
    - `label` string, required
    - `type` 'short' | 'long' | 'yes_no', required
    - `required` boolean, required
  - `closing_date` string, date, nullable, required
  - `daily_limit` integer, nullable, required
  - `confirm_email` boolean, required
  - `eeo` boolean, required
  - `checklist` object, required
    - `on` boolean, required
    - `items` object[], required
      - `key` string, required
      - `label` string, required
      - `custom` boolean, required
  - `published_by` string, nullable, required
  - `closed_by` string, nullable, required
  - `postings` object[], required
    - `board` string, required
    - `board_name` string, required
    - `by` string, required
    - `at` string, date-time, required
  - `posting_kit` object, nullable, required
    - `text` string, required
    - `boards` object[], required
      - `key` string, required
      - `name` string, required
      - `url` string, required
      - `link` string, required
      - `note` string, required
  - `history` object[], required
    - `title` string, required
    - `location` object, required
      - `kind` 'on_site' | 'hybrid' | 'remote', required
      - `place` object, nullable, required
        - `city` string, required
        - `region` string, nullable, required
        - `country` string, required
      - `remote_region` string, nullable, required
    - `pay` object, nullable, required
      - `min` string, required
      - `max` string, required
      - `currency` string, required
      - `period` 'year' | 'hour', required
    - `no_range` object, nullable, required
      - `reason` string, required
      - `by` string, required
      - `at` string, date-time, required
    - `benefits` string, required
    - `published_by` string, required
    - `published_at` string, date-time, required
  - `facts` object, required
    - `version` string, required
    - `pay` object[], required
      - `key` string, required
      - `jurisdiction` string, required
      - `fact` string, required
      - `source` string, required
      - `checked` string, date, required
      - `remote` string, required
    - `questions` object[], required
      - `key` string, required
      - `jurisdiction` string, required
      - `fact` string, required
      - `source` string, required
      - `checked` string, date, required
      - `where` string, required
      - `topic` string, required

## Other responses

- `default`: An RFC 9457 problem.

---

[API](https://skmtc.dev/binderwork/apis/binderwork-api.md) · [All operations](https://skmtc.dev/binderwork/apis/binderwork-api/llms.txt) · [OpenAPI document](https://skmtc.dev/binderwork/apis/binderwork-api/revisions/f8fab0ebee53?raw)