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

# Create submissions

> Create new submissions for a form

Once imported, your submissions will be visible in the "Results" tab of the form editor.

<Note>
  **Note:** Submissions created via API will not trigger email notifications, workflows, or integrations.
</Note>


## OpenAPI

````yaml POST /forms/{formId}/submissions
openapi: 3.0.1
info:
  title: Fillout REST API
  description: A REST API for managing forms, submissions, and webhooks in Fillout
  version: 1.0.0
servers:
  - url: https://api.fillout.com/v1/api
    description: US server
  - url: https://eu-api.fillout.com/v1/api
    description: EU server
security:
  - bearerAuth: []
paths:
  /forms/{formId}/submissions:
    post:
      summary: Create submissions
      description: Create new submissions for a form
      operationId: createSubmissions
      parameters:
        - name: formId
          in: path
          required: true
          schema:
            type: string
          description: The public identifier of the form
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateSubmissionsRequest'
      responses:
        '200':
          description: Created submissions
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateSubmissionsResponse'
components:
  schemas:
    CreateSubmissionsRequest:
      type: object
      properties:
        submissions:
          type: array
          maxItems: 10
          items:
            $ref: '#/components/schemas/CreateSubmissionData'
          description: List of submissions to create (maximum 10)
      required:
        - submissions
    CreateSubmissionsResponse:
      type: object
      properties:
        submissions:
          type: array
          items:
            $ref: '#/components/schemas/Submission'
          description: List of created submissions
      required:
        - submissions
    CreateSubmissionData:
      type: object
      properties:
        questions:
          type: array
          items:
            $ref: '#/components/schemas/CreateQuestionResponse'
          description: List of question responses (required)
        urlParameters:
          type: array
          items:
            $ref: '#/components/schemas/UrlParameterResponse'
          description: List of URL parameter values (optional)
        submissionTime:
          type: string
          format: date-time
          description: When the submission was made (optional)
        lastUpdatedAt:
          type: string
          format: date-time
          description: When the submission was last updated (optional)
        scheduling:
          type: array
          items:
            $ref: '#/components/schemas/CreateSchedulingResponse'
          description: List of scheduling responses (optional)
        payments:
          type: array
          items:
            $ref: '#/components/schemas/CreatePaymentResponse'
          description: List of payment responses (optional)
        login:
          $ref: '#/components/schemas/LoginResponse'
          description: Login information (optional)
      required:
        - questions
    Submission:
      type: object
      properties:
        submissionId:
          type: string
          description: Unique identifier for the submission
        submissionTime:
          type: string
          format: date-time
          description: When the submission was made
        lastUpdatedAt:
          type: string
          format: date-time
          description: When the submission was last updated
        questions:
          type: array
          items:
            $ref: '#/components/schemas/QuestionResponse'
          description: List of question responses
        calculations:
          type: array
          items:
            $ref: '#/components/schemas/CalculationResponse'
          description: List of calculation responses
        urlParameters:
          type: array
          items:
            $ref: '#/components/schemas/UrlParameterResponse'
          description: List of URL parameter values
        scheduling:
          type: array
          items:
            $ref: '#/components/schemas/SchedulingResponse'
          description: List of scheduling responses (if using Fillout Scheduling)
        payments:
          type: array
          items:
            $ref: '#/components/schemas/PaymentResponse'
          description: List of payment responses (if using Fillout Payments)
        quiz:
          $ref: '#/components/schemas/QuizResponse'
          description: Quiz results (if form is configured as quiz)
        login:
          $ref: '#/components/schemas/LoginResponse'
          description: Login information (if using login page)
      required:
        - submissionId
        - submissionTime
        - questions
    CreateQuestionResponse:
      type: object
      properties:
        id:
          type: string
          description: Identifier of the question
        value:
          description: The response value
      required:
        - id
        - value
    UrlParameterResponse:
      type: object
      properties:
        id:
          type: string
          description: Identifier of the URL parameter
        name:
          type: string
          description: Name of the URL parameter
        value:
          type: string
          description: Value of the URL parameter
      required:
        - id
        - name
        - value
    CreateSchedulingResponse:
      type: object
      properties:
        id:
          type: string
          description: Identifier of the scheduling field
        value:
          $ref: '#/components/schemas/CreateSchedulingValue'
          description: Scheduling details
      required:
        - id
        - value
    CreatePaymentResponse:
      type: object
      properties:
        id:
          type: string
          description: Identifier of the payment field
        value:
          $ref: '#/components/schemas/CreatePaymentValue'
          description: Payment details
      required:
        - id
        - value
    LoginResponse:
      type: object
      properties:
        email:
          type: string
          format: email
          description: Verified email address
      required:
        - email
    QuestionResponse:
      type: object
      properties:
        id:
          type: string
          description: Identifier of the question
        name:
          type: string
          description: The question text
        type:
          type: string
          description: The type of the question
        value:
          description: The response value
      required:
        - id
        - name
        - type
        - value
    CalculationResponse:
      type: object
      properties:
        id:
          type: string
          description: Identifier of the calculation
        name:
          type: string
          description: Name of the calculation
        type:
          type: string
          enum:
            - number
            - text
            - duration
          description: Type of the calculation
        value:
          type: string
          description: The calculated value
      required:
        - id
        - name
        - type
        - value
    SchedulingResponse:
      type: object
      properties:
        id:
          type: string
          description: Identifier of the scheduling field
        name:
          type: string
          description: Name of the scheduling field
        value:
          $ref: '#/components/schemas/SchedulingValue'
          description: Scheduling details
      required:
        - id
        - name
        - value
    PaymentResponse:
      type: object
      properties:
        id:
          type: string
          description: Identifier of the payment field
        name:
          type: string
          description: Name of the payment field
        value:
          $ref: '#/components/schemas/PaymentValue'
          description: Payment details
      required:
        - id
        - name
        - value
    QuizResponse:
      type: object
      properties:
        score:
          type: integer
          description: Quiz score
        maxScore:
          type: integer
          description: Maximum possible score
      required:
        - score
        - maxScore
    CreateSchedulingValue:
      type: object
      properties:
        fullName:
          type: string
          description: Full name of the person booking
        email:
          type: string
          format: email
          description: Email of the person booking
        eventStartTime:
          type: string
          format: date-time
          description: Start time of the event
        eventEndTime:
          type: string
          format: date-time
          description: End time of the event
        timezone:
          type: string
          description: Timezone for the meeting
        userId:
          type: integer
          description: User ID (optional)
        scheduledUserEmail:
          type: string
          format: email
          description: Email of the scheduled user (optional)
        eventId:
          type: string
          description: Calendar event ID (optional)
        eventUrl:
          type: string
          format: uri
          description: URL to the calendar event (optional)
        rescheduleOrCancelUrl:
          type: string
          format: uri
          description: URL to reschedule or cancel the event (optional)
        meetingNotes:
          type: string
          description: Meeting notes (optional)
      required:
        - fullName
        - email
        - eventStartTime
        - eventEndTime
        - timezone
    CreatePaymentValue:
      type: object
      properties:
        paymentId:
          type: string
          description: Stripe payment ID
        stripeCustomerId:
          type: string
          description: Stripe customer ID (optional)
        stripeCustomerUrl:
          type: string
          format: uri
          description: URL to Stripe customer dashboard (optional)
        stripePaymentUrl:
          type: string
          format: uri
          description: URL to Stripe payment dashboard (optional)
        totalAmount:
          type: integer
          description: Total amount in cents (optional)
        currency:
          type: string
          description: Currency code (optional)
        email:
          type: string
          format: email
          description: Customer email (optional)
        status:
          type: string
          description: Payment status (optional)
        stripeSubscriptionId:
          type: string
          description: Stripe subscription ID (optional)
      required:
        - paymentId
    SchedulingValue:
      type: object
      properties:
        fullName:
          type: string
          description: Full name of the person booking
        email:
          type: string
          format: email
          description: Email of the person booking
        timezone:
          type: string
          description: Timezone for the meeting
        eventStartTime:
          type: string
          format: date-time
          description: Start time of the event
        eventEndTime:
          type: string
          format: date-time
          description: End time of the event
        eventId:
          type: string
          description: Calendar event ID
        eventUrl:
          type: string
          format: uri
          description: URL to the calendar event
        rescheduleOrCancelUrl:
          type: string
          format: uri
          description: URL to reschedule or cancel the event
        userId:
          type: integer
          description: User ID (optional)
        scheduledUserEmail:
          type: string
          format: email
          description: Email of the scheduled user (optional)
        meetingNotes:
          type: string
          description: Meeting notes (optional)
      required:
        - fullName
        - email
        - timezone
        - eventStartTime
        - eventEndTime
    PaymentValue:
      type: object
      properties:
        paymentId:
          type: string
          description: Stripe payment ID
        stripeCustomerId:
          type: string
          description: Stripe customer ID (optional)
        stripeCustomerUrl:
          type: string
          format: uri
          description: URL to Stripe customer dashboard (optional)
        stripePaymentUrl:
          type: string
          format: uri
          description: URL to Stripe payment dashboard (optional)
        totalAmount:
          type: integer
          description: Total amount in cents (optional)
        currency:
          type: string
          description: Currency code (optional)
        email:
          type: string
          format: email
          description: Customer email (optional)
        discountCode:
          type: string
          description: Discount code used (optional)
        status:
          type: string
          description: Payment status (optional)
        stripeSubscriptionId:
          type: string
          description: Stripe subscription ID (optional)
      required:
        - paymentId
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Enter your [Fillout API
        key](https://build.fillout.com/home/settings/developer). Format: Bearer
        <api_key>

````