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

# applicationUpdate

`POST applicationUpdate` (webhook)

Triggered when there's an update to an application. This includes:
- Changes to application fields (source, custom fields, etc.)
- Job transfers (when an application is moved to a different job)
- Also triggered by [candidateHire](https://developers.ashbyhq.com/reference/candidatehirewebhook) and [candidateStageChange](https://developers.ashbyhq.com/reference/candidatestagechangewebhook)

## Payload

- object
  - `action` 'applicationUpdate', required
  - `data` object, required
    - `application` OverlayApplication
      - `id` string, uuid, required
      - `createdAt` string, date-time, required
      - `updatedAt` string, date-time, required
      - `status` 'Hired' | 'Archived' | 'Active' | 'Lead', required — The status of the application
      - `customFields` OverlayCustomField[]
        - `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
      - `candidate` object, required — The candidate associated with the application
        - `id` string, uuid, required
        - `name` string, required
        - `primaryEmailAddress` OverlayContactInfo
          - `value` string, required — The email address or phone number of the candidate
          - `type` 'Personal' | 'Work' | 'Other', required — The type of the contact info
          - `isPrimary` boolean, required — Whether the contact info is the primary email or phone number
        - `primaryPhoneNumber` object
          - `value` string, required — The email address or phone number of the candidate
          - `type` 'Personal' | 'Work' | 'Other', required — The type of the contact info
          - `isPrimary` boolean, required — Whether the contact info is the primary email or phone number
      - `currentInterviewStage` OverlayInterviewStage, required
        - `id` string, uuid, required
        - `title` string, required
        - `type` string, required
        - `orderInInterviewPlan` integer, required
        - `interviewStageGroupId` string
        - `interviewPlanId` string, uuid, required
      - `source` OverlaySource
        - `id` string, uuid, required
        - `title` string, required
        - `isArchived` boolean, required
        - `sourceType` OverlaySourceType
          - `id` string, uuid, required
          - `title` string, required
          - `isArchived` boolean, required
      - `archiveReason` ArchiveDetails
        - `id` string, uuid, required
        - `text` string, required
        - `reasonType` 'RejectedByCandidate' | 'RejectedByOrg' | 'Other', required
        - `isArchived` boolean, required
        - `customFields` OverlayCustomField[], required — Archive detail custom field values
          - `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
      - `archivedAt` string, date-time — The timestamp an application was archived
      - `job` object, required
        - `id` string, required
        - `title` string, required
        - `locationId` string, uuid
        - `departmentId` string, uuid
      - `creditedToUser` 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
      - `hiringTeam` OverlayHiringTeamRole[], required
        - `email` string, required
        - `firstName` string, required
        - `lastName` string, required
        - `role` string, required
        - `userId` string, uuid, required
      - `appliedViaJobPostingId` string, uuid — The id of the first job posting the candidate applied through. If the candidate submitted applications via multiple job postings for the same job, this will be the earliest one.
      - `submitterClientIp` string — The IP address (can be v4 or v6) of the client that submitted the application, if it was submitted through the external job board.
      - `submitterUserAgent` string — The user agent of the client that submitted the application, if it was submitted through the external job board.

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