---
title: "openingCreate"
method: POST
path: "openingCreate"
tags: ["Webhook Payloads"]
---

# openingCreate

`POST openingCreate` (webhook)

Triggered when a opening is created

## Payload

- object
  - `action` 'openingCreate', required
  - `data` object, required
    - `opening` OverlayOpening
      - `id` string, uuid, required
      - `openedAt` string, date-time
      - `closedAt` string, date-time
      - `isArchived` boolean, required
      - `archivedAt` string, date-time
      - `closeReasonId` string, uuid
      - `openingState` 'Approved' | 'Closed' | 'Draft' | 'Filled' | 'Open', required
      - `latestVersion` OverlayOpeningVersion
        - `id` string, uuid, required
        - `identifier` string, required
        - `description` string, required
        - `authorId` string, uuid, required
        - `createdAt` string, date-time, required
        - `teamId` string, uuid
        - `jobIds` Id[], required
        - `targetHireDate` string
        - `targetStartDate` string
        - `isBackfill` boolean, required
        - `employmentType` 'FullTime' | 'PartTime' | 'Intern' | 'Contract' | 'Temporary', required
        - `locationIds` Id[], required
        - `hiringTeam` OverlayHiringTeamRole[], required
          - `email` string, required
          - `firstName` string, required
          - `lastName` string, required
          - `role` string, required
          - `userId` string, uuid, required
        - `customFields` OverlayCustomField[], required — An array of custom fields associated with the opening
          - `id` string, uuid, required
          - `isPrivate` boolean
          - `title` string, required
          - `valueLabel` union — The label of the custom field value. This is only present for value select custom fields.
            - string
            - string[]
          - `value` union, required
            - boolean
            - object
              - …
            - string, date-time
            - string
            - string
            - string[]
            - number
            - object
              - …
            - object
              - …
            - string

## Acknowledgement `200`

Return a 200 status to indicate that the data was received successfully

---

[API](https://skmtc.net/ashbyhq/apis/ashby-api.md) · [All operations](https://skmtc.net/ashbyhq/apis/ashby-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ashbyhq/ashby-api/revisions/778b919dc743/schema)