> ## Documentation Index
> Fetch the complete documentation index at: https://docs.paubox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Submit a form response

> Submits a respondent's answers for a form. No authentication required. On success, the service stores the submission, increments the form's submission count, emails recipients (if configured), and returns 201 with no body.

Maximum request size is **250 MB** (to support file attachments).




## OpenAPI

````yaml openapi-forms POST /api/forms/{form_id}/submissions
openapi: 3.0.0
info:
  title: Paubox Forms API
  description: >
    Public endpoints for embedding and submitting Paubox Forms. No API key
    required — these endpoints are called by form respondents, not by
    authenticated API consumers.
  version: 1.0.0
servers:
  - url: https://apx.paubox.com/forms
    description: Paubox Forms API
security: []
tags:
  - name: Forms
    description: Retrieve form definitions and accept submissions
paths:
  /api/forms/{form_id}/submissions:
    post:
      tags:
        - Forms
      summary: Submit a form response
      description: >
        Submits a respondent's answers for a form. No authentication required.
        On success, the service stores the submission, increments the form's
        submission count, emails recipients (if configured), and returns 201
        with no body.


        Maximum request size is **250 MB** (to support file attachments).
      operationId: createFormSubmission
      parameters:
        - name: form_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: UUID of the form being submitted
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FormSubmissionRequest'
            examples:
              basic:
                summary: Text fields only
                value:
                  form_data:
                    first_name: Jane
                    last_name: Smith
                    email: jane@example.com
              with_attachments:
                summary: With file attachments
                value:
                  form_data:
                    first_name: Jane
                    signature: '{signature_field}'
                  attachments:
                    - name: consent.pdf
                      content: JVBERi0xLjQ...
      responses:
        '201':
          description: Submission accepted
        '400':
          description: Missing required `form_data` field
        '404':
          description: Form not found
components:
  schemas:
    FormSubmissionRequest:
      type: object
      required:
        - form_data
      properties:
        form_data:
          type: object
          description: >
            Key-value pairs matching the form's field schema (`form_json`).
            Structure varies per form.
        attachments:
          type: array
          description: Optional file attachments
          items:
            type: object
            required:
              - name
              - content
            properties:
              name:
                type: string
                description: Filename
              content:
                type: string
                description: Base64-encoded file content

````