---
title: "Create Form Submission"
url: "https://developer-qual.migros.ch/apis/formigros-qual-0/versions/5cf4bb7f-1e47-4efc-a301-5c2ff79fea16/operations/createFormSubmission"
---

> Full API specification: https://developer-qual.migros.ch/apis/formigros-qual-0/versions/5cf4bb7f-1e47-4efc-a301-5c2ff79fea16.md

# Create Form Submission

`POST` `/migros/forms/v1/{formPath}/submission`

Operation ID: `createFormSubmission`

Creates a new submission for the given form alias. Include _fvid to target a specific form revision.

## Path parameters

- `formPath` (string, required) - Form Alias

## Request body

Content types: `application/json`

## Responses

- `201` - Create Form Submission / Create Submission / Create Form Revision Submission

## OpenAPI definition

```yaml
openapi: 3.0.1
info:
  title: Formigros QUAL
  version: 0.0.1
servers:
  - url: https://api-qual.migros.ch
paths:
  /migros/forms/v1/{formPath}/submission:
    post:
      description: Creates a new submission for the given form alias. Include _fvid to
        target a specific form revision.
      operationId: createFormSubmission
      parameters:
        - description: Form Alias
          in: path
          name: formPath
          required: true
          schema:
            example: AmazingContactForm
            type: string
      requestBody:
        content:
          application/json:
            examples:
              Create Form Submission:
                value:
                  _fvid: "2"
                  data:
                    email: joe@example.com
                    firstName: Joe
                    lastName: Smith
                    phoneNumber: (123) 123-1234
            schema:
              properties:
                _fvid:
                  example: "2"
                  type: string
                data:
                  properties:
                    email:
                      example: joe@example.com
                      type: string
                    firstName:
                      example: Joe
                      type: string
                    lastName:
                      example: Smith
                      type: string
                    phoneNumber:
                      example: (123) 123-1234
                      type: string
                  type: object
              type: object
      responses:
        "201":
          content:
            application/json:
              examples:
                Create Form Revision Submission:
                  value:
                    _fvid: 2
                    _id: 662fc7e23d908589b89322e5
                    access: []
                    created: 2024-04-29T16:16:34.219Z
                    data:
                      email: joe@example.com
                      firstName: Joe
                      lastName: Smith
                      phoneNumber: (123) 123-1234
                    externalIds: []
                    form: 662fc76b3d908589b8931efb
                    modified: 2024-04-29T16:16:34.220Z
                    owner: 662fc7483d908589b8931c16
                    project: 662fc74e3d908589b8931c52
                    roles: []
                    state: submitted
                Create Form Submission:
                  value:
                    _fvid: 1
                    _id: 5fc7c4082a992abe68b247b9
                    _vid: 0
                    access: []
                    created: 2020-12-02T16:42:48.128Z
                    data:
                      email: joe@example.com
                      firstName: Joe
                      lastName: Smith
                      phoneNumber: (123) 123-1234
                    externalIds: []
                    form: 5fc7c25a2a992abe68b247b4
                    modified: 2020-12-02T16:42:48.129Z
                    owner: 5fc7beeb2a992abe68b2475c
                    project: 5fc7befe2a992abe68b24765
                    roles: []
                    state: submitted
                Create Submission:
                  value:
                    _id: 57d0a2fd76f943a4007e1529
                    access: []
                    created: 2016-09-07T23:30:05.757Z
                    data:
                      email: joe@example.com
                      firstName: Joe
                      lastName: Smith
                      phoneNumber: "123123123"
                    externalIds: []
                    form: 57d0a2f876f943a4007e1527
                    modified: 2016-09-07T23:30:05.758Z
                    owner: 57d010fe76f943a4007e11da
                    roles: []
              schema:
                properties:
                  _fvid:
                    example: 1
                    type: number
                  _id:
                    example: 5fc7c4082a992abe68b247b9
                    type: string
                  _vid:
                    example: 0
                    type: number
                  access:
                    example: []
                    items: {}
                    type: array
                  created:
                    example: 2020-12-02T16:42:48.128Z
                    type: string
                  data:
                    properties:
                      email:
                        example: joe@example.com
                        type: string
                      firstName:
                        example: Joe
                        type: string
                      lastName:
                        example: Smith
                        type: string
                      phoneNumber:
                        example: (123) 123-1234
                        type: string
                    type: object
                  externalIds:
                    example: []
                    items: {}
                    type: array
                  form:
                    example: 5fc7c25a2a992abe68b247b4
                    type: string
                  modified:
                    example: 2020-12-02T16:42:48.129Z
                    type: string
                  owner:
                    example: 5fc7beeb2a992abe68b2475c
                    type: string
                  project:
                    example: 5fc7befe2a992abe68b24765
                    type: string
                  roles:
                    example: []
                    items: {}
                    type: array
                  state:
                    example: submitted
                    type: string
                type: object
          description: Create Form Submission / Create Submission / Create Form Revision
            Submission
      summary: Create Form Submission
      tags:
        - Submission API
```