---
title: "Create a submission"
method: POST
path: "/forms/{form_id}/submissions"
---

# Create a submission

`POST /forms/{form_id}/submissions`

## Request

- Base URL: `https://app.formasty.com/api/v1`
- URL: `https://app.formasty.com/api/v1/forms/{form_id}/submissions`
- Auth: one of:
  - OAuth 2 (authorization code, authorization URL `https://app.formasty.com/oauth/authorize/api/v1`, token URL `https://app.formasty.com/oauth/token`)
  - HTTP bearer

Creates a submission against the current published form snapshot.

## Path parameters

- `form_id` string, required

## Request body

- object
  - `values` object

## Response `201`

Created submission and thank-you payload.

- SubmissionCreateResponse
  - `submission` SubmissionRecord, required
    - `event` string, required
    - `eventId` string, required
    - `form` object, required
      - `id` string, required
      - `publicId` string, required
      - `name` string, required
      - `workspaceId` string, required
      - `publishedAt` string, nullable
      - `version` integer, required
    - `submission` object, required
      - `id` string, required
      - `createdAt` string, required
    - `answers` object, required
    - `fields` object[], required
      - `id` string, required
      - `label` string, required
      - `value` unknown, required
    - `meta` object, required
    - `answersByFieldId` object, required
  - `thank_you` object, required
  - `redirect_to` string

## Other responses

- `default`: A machine-readable error with a stable code and a recovery hint. The legacy error value is retained for existing clients.

---

[API](https://skmtc.dev/formasty/apis/formasty-forms-api.md) · [All operations](https://skmtc.dev/formasty/apis/formasty-forms-api/llms.txt) · [OpenAPI document](https://skmtc.dev/formasty/apis/formasty-forms-api/revisions/09ad7f50c693?raw)