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

# jobCreate

`POST jobCreate` (webhook)

Triggered when a job is created

## Payload

- object
  - `action` 'jobCreate', required
  - `data` object, required
    - `job` OverlayJob
      - `id` string, uuid, required
      - `title` string, required
      - `confidential` boolean, required
      - `status` 'Draft' | 'Open' | 'Closed' | 'Archived', required
      - `employmentType` 'FullTime' | 'PartTime' | 'Intern' | 'Contract' | 'Temporary', required
      - `locationId` string, uuid — The id of the location of the job
      - `departmentId` string, uuid — The id of the department or team associated with the job
      - `defaultInterviewPlanId` string, uuid — The id of the default interview plan for this job posting. A job cannot be opened without a default interview plan.
      - `interviewPlanIds` string[]
      - `customFields` OverlayCustomField[] — An array of custom fields associated with the job
        - `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
            - `value` number
            - `currencyCode` string
          - string, date-time
          - string
          - string
          - string[]
          - number
          - object
            - `type` string, required
            - `minValue` number, required
            - `maxValue` number, required
          - object
            - `type` string, required
            - `minValue` number, required
            - `maxValue` number, required
            - `currencyCode` string, required
            - `interval` 'NONE' | '1 TIME' | '1 HOUR' | '1 DAY' | '1 WEEK' | '2 WEEK' | '1 MONTH' | '2 MONTH' | '1 YEAR' | '6 MONTH' | '0.5 MONTH' | '3 MONTH', required
          - string
      - `jobPostingIds` string[]
      - `customRequisitionId` string, uuid — The custom requisition id for a job
      - `brandId` string, uuid — The id of the brand to use for this job
      - `hiringTeam` OverlayHiringTeamRole[]
        - `email` string, required
        - `firstName` string, required
        - `lastName` string, required
        - `role` string, required
        - `userId` string, uuid, required
      - `author` OverlayUser
        - `id` string, uuid, required
        - `firstName` string, required
        - `lastName` string, required
        - `email` string
        - `globalRole` 'Organization Admin' | 'Elevated Access' | 'Limited Access' | 'External Recruiter', required
        - `isEnabled` boolean, required
        - `updatedAt` string, date-time, required
        - `managerId` string, uuid
        - `customFields` OverlayCustomField[] — Custom field values associated with the user. **Note:** This field requires a feature to be enabled for your organization. If it is not present in the response, please contact Ashby support to have it enabled.
          - `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
      - `createdAt` string, date-time
      - `updatedAt` string, date-time, required
      - `openedAt` string, date-time
      - `closedAt` string, date-time

## 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)