---
title: "Submit Form"
method: POST
path: "/public/forms/{form_id}/submit"
tags: ["public-forms"]
---

# Submit Form

`POST /public/forms/{form_id}/submit`

## Request

- Base URL: `https://api.feedback1.ai/api/v1`
- URL: `https://api.feedback1.ai/api/v1/public/forms/{form_id}/submit`
- Auth: none declared

Submit a form response.

This endpoint:
1. Validates all required fields are answered
2. Creates a FormResponse record
3. Creates FormResponseAnswer records for each answer
4. Optionally creates a Feedback item (if configured in form settings)

## Path parameters

- `form_id` string, required

## Request body

- FormSubmission: Submit form response (public endpoint)
  - `answers` FormResponseAnswerBase[], required
    - `block_id` integer, required
    - `answer_value` string, nullable
    - `answer_json` unknown
  - `respondent_email` string, nullable
  - `respondent_name` string, nullable
  - `source_url` string, nullable
  - `turnstile_token` string, nullable

## Response `200`

Successful Response

- PublicFormSubmitResponse: Response after submitting form
  - `success` boolean, required
  - `response_id` string, required
  - `thank_you_message` string, required
  - `thank_you_description` string, nullable
  - `redirect_url` string, nullable
  - `redirect_delay_seconds` integer

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/feedback1/apis/feedback1-public-api.md) · [All operations](https://skmtc.dev/feedback1/apis/feedback1-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/feedback1/apis/feedback1-public-api/revisions/e7626420f622?raw)