---
title: "applicationFeedback.submit"
method: POST
path: "/applicationFeedback.submit"
tags: ["Application Feedback"]
---

# applicationFeedback.submit

`POST /applicationFeedback.submit`

Application feedback forms support a variety of field types.

The values accepted for each field depend on the type of field that's being filled out:
- `Boolean` - A boolean value
- `CompensationRange` - An object in the format `{ type: "compensation-range", minValue: 100000, maxValue: 150000, currencyCode: "USD", interval: "1 YEAR" }`. `currencyCode` must be a valid ISO 4217 code and `interval` must be a valid compensation interval (e.g. `"1 HOUR"`, `"1 YEAR"`).
- `Currency` - An object in the format `{ value: 100000, currencyCode: "USD" }`. `currencyCode` must be a valid ISO 4217 code.
- `Date` - A date string in the format YYYY-MM-DD
- `Email` - A valid email address
- `LongText`, `Phone`, `String` - A string
- `MultiValueSelect` - An array of strings that exist in the MultiValueSelect field's selectable options
- `Number` - An integer
- `NumberRange` - An object in the format `{ type: "number-range", minValue: 1, maxValue: 10 }`
- `RichText` - We do not support submitting rich text documents via the API but we do support submitting plain text values for these fields. Plain text values must be submitted in the format `{ type: "PlainText", value: "A plain text string" }`
- `Score` - An object in the format `{ score: 4 }` where `score` is an integer between 1 and 4 inclusive. Optionally include `comments` as plain text: `{ score: 4, comments: { type: "PlainText", value: "A plain text string" } }`. Comments are returned in the same PlainText shape in `submittedValues`.
- `Url` - A valid URL string. The empty string is also accepted.
- `UUID` - A UUID string, or an object in the format `{ value: "<uuid>" }`
- `ValueSelect` - A string that matches the value of one of the ValueSelect field's selectable options

The `submittedValues` field in the response contains the submitted feedback in an object where the key is the path of the field and the value is the value submitted for that field.

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

## Request body

- ApplicationFeedbackSubmitRequest
  - `feedbackForm` object, required — The application feedback form data containing field submissions
    - `fieldSubmissions` object[], required — The submitted values for the feedback form fields
      - `path` string, required — The form field "path" value
      - `value` unknown, required
  - `formDefinitionId` string, uuid, required — The id of the feedback form definition associated with the form submission
  - `applicationId` string, uuid, required — The id of the application you're submitting feedback for
  - `userId` string, uuid, nullable — The id of the user the feedback will be credited to. If omitted, the feedback will be credited to the API key user.
  - `interviewEventId` string, uuid, nullable — The id of the interview event you're submitting feedback for

## Response `200`

Responses from the applicationFeedback.submit endpoint

- union
  - ApplicationFeedbackSubmitSuccessResponse
    - `success` true, required
    - `results` ApplicationFeedbackSubmitResult, required
      - `submittedFormInstance` FormSubmissionInstance, required
        - `id` string, uuid, required — The unique identifier for the submitted form instance
        - `formDefinition` FormDefinition, required
          - `sections` FormDefinitionSection[], required — The sections in the form definition
            - `title` string, nullable — The section title
            - `descriptionHtml` string, nullable — The section description formatted as HTML
            - `descriptionPlain` string, nullable — The section description as plain text
            - `fields` FormDefinitionFieldEntry[], required — The fields in this form section
              - …
        - `submittedValues` object, required — Submitted values keyed by the corresponding form field path
  - 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)