---
title: "applicationForm.submit"
method: POST
path: "/applicationForm.submit"
tags: ["Application Form"]
---

# applicationForm.submit

`POST /applicationForm.submit`

Submits a completed application form for a job posting.

**Requires the [`candidatesWrite`](authentication#permissions-applicationformsubmit) permission.**

## Request body

- ApplicationFormSubmitRequest
  - `jobPostingId` string, uuid, required — The id of the job posting to submit the application for
  - `applicationForm` object, required — The application form data containing field submissions
    - `fieldSubmissions` object[], required — The list of field values to submit for the application form
      - `path` string, required — The path of the application form field being submitted
      - `value` unknown, required
  - `utmData` object, nullable — Optional UTM tracking data
    - `utm_source` string, nullable — The source UTM parameter for the application
    - `utm_medium` string, nullable — The medium UTM parameter for the application
    - `utm_campaign` string, nullable — The campaign UTM parameter for the application
    - `utm_term` string, nullable — The term UTM parameter for the application
    - `utm_content` string, nullable — The content UTM parameter for the application
  - `tagIds` string[], nullable — Optional array of tag ids to apply to the candidate
  - `allowSubmissionForUnpublishedJobPosting` boolean, nullable, required — If false, applications for unpublished job postings will be rejected. Defaults to true.

## Response `200`

Responses from the applicationForm.submit endpoint

- union
  - ApplicationFormSubmitSuccessResponse
    - `success` true, required
    - `results` ApplicationFormSubmitResult, required
      - `submittedFormInstance` ApplicationFormSubmittedFormInstance, required
        - `id` string, uuid, required — The unique identifier for the submitted form instance
        - `formDefinition` ApplicationFormDefinition, required
          - `sections` ApplicationFormSection[], required — The sections in the form
            - `title` string, nullable — The section title, when present
            - `descriptionHtml` string, nullable — The section description rendered as HTML, when present
            - `descriptionPlain` string, nullable — The section description rendered as plain text, when present
            - `fields` ApplicationFormDefinitionField[], required — The fields contained in the section
              - …
        - `submittedValues` object, required — The submitted values keyed by application form field path
      - `formMessages` object, required — Messages associated with the form submission
        - `blocked` boolean, required — Whether the application was blocked by a blocking rule
        - `blockMessageForCandidateHtml` string, nullable — The HTML message shown to the candidate when the application is blocked
  - ErrorResponse
    - `success` false, required
    - `errors` ErrorDetail[], required
      - `message` string, required
      - `parameter` string

---

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