---
title: "Create a new form submission."
method: POST
path: "/forms/submissions"
tags: ["forms"]
---

# Create a new form submission.

`POST /forms/submissions`

Creates a new form submission.

## Headers

- `organization-id` string

## Request body

- CreateFormSubmissionDto
  - `data` object, required — A flexible object for storing any data related to a form submission. This can include details about the form, the submitted data, and metadata about the submission process.

## Response `201`

Form submission created successfully.

- FormSubmissionResponseDto
  - `id` string — The unique identifier for the form submission.
  - `organizationId` string — The unique identifier for the client organization within Certify.
  - `mappedData` object — The mapped responses for the form submission. The structure of this object is flexible and can vary based on the form and its fields. Please request the specific structure from the Certify team if needed.
  - `submissionData` object — The raw responses for the form submission. The structure of this object is flexible and can vary based on the form and its fields. Please request the specific structure from the Certify team if needed.
  - `submissionPdf` object — The PDF document of the form submission, if available.
  - `submittedBy` FormSubmissionSubmittedByResponseDto
    - `email` string, required — The email of the user who submitted the form.
    - `user` object — The user information of the person who submitted the form.
  - `form` object — Information about the form associated with the submission.
  - `formVersionId` string — The id of the version of the form used for this submission.
  - `createdAt` string, required — The date and time when the form submission was created
  - `createdBy` string, required — The identifier of the user or system that created the submission.
  - `updatedAt` string, required — The date and time when the form submission was last updated

## Other responses

- `400` — Invalid request body or missing required fields.
- `401` — Unauthorized if authorization token is not provided or invalid.
- `403` — Forbidden if user access is not right.

---

[API](https://skmtc.net/certifyos/apis/certifyos-api.md) · [All operations](https://skmtc.net/certifyos/apis/certifyos-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/certifyos/certifyos-api/versions/df08dd00da43/schema)