---
title: "surveySubmission.create"
method: POST
path: "/surveySubmission.create"
tags: ["Survey Submission"]
---

# surveySubmission.create

`POST /surveySubmission.create`

Creates a survey submission for a candidate and application.

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

## Request body

- SurveySubmissionCreateRequest
  - `surveyFormDefinitionId` string, uuid, required — The unique identifier of the survey form definition to submit
  - `candidateId` string, uuid, required — The unique identifier of the candidate submitting the survey
  - `applicationId` string, uuid, required — The unique identifier of the associated application
  - `submittedValues` object, required — A map of form field paths to submitted values

## Response `200`

Responses from the surveySubmission.create endpoint

- union
  - SurveySubmissionCreateSuccessResponse
    - `success` true, required
    - `results` SurveySubmission, required
      - `id` string, uuid, required — The unique identifier for the survey submission
      - `surveyFormDefinitionId` string, uuid, nullable — The unique identifier for the survey form definition
      - `submittedAt` string, date-time, required — The date and time when the survey was submitted
      - `candidateId` string, uuid, required — The unique identifier for the associated candidate
      - `applicationId` string, uuid, nullable — The unique identifier for the associated application
      - `surveyType` 'EEOC' | 'Diversity' | 'CandidateExperience' | 'CandidateDataConsent' | 'Questionnaire' | 'QualityOfHire' | 'HiringManagerExperience', required — The type of survey
      - `formDefinition` FormDefinition
        - `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
            - `isRequired` boolean, required — Whether this form field is required
            - `descriptionHtml` string, nullable — The field description formatted as HTML
            - `descriptionPlain` string, nullable — The field description as plain text
            - `field` FormDefinitionField, required
              - …
      - `submittedValues` object, nullable — A map of form field paths to submitted values
  - 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)