createSubmission( )


Creates a submission.

The createSubmission() function is an alternative way to the WixFormsV2 element for submitting a form. In this case, clicking the submit button is unnecessary, the submission is automatically created when calling this function.

Permissions
Manage Submissions
Learn more about app permissions.
Method Declaration
Copy
function createSubmission(
  submission: FormSubmission,
  options: CreateSubmissionOptions,
): Promise<FormSubmission>;
Method Parameters
submissionFormSubmissionRequired

Submission to create.


optionsCreateSubmissionOptions

Optional fields.

Returns
Return Type:Promise<FormSubmission>
JavaScript
import { submissions } from "@wix/forms"; /* Sample submission value: { "formId": "21bcb6c7-02b3-4ed1-b6db-7856094fac03", "seen": false, "status": "PENDING", "submissions": { "first_name": "Patsy", "last_name": "McBride" } } */ export async function myCreateSubmissionFunction(submission, options) { try { const createdSubmission = await submissions.createSubmission( submission, options, ); console.log("Success! Created submission:", createdSubmission); return createdSubmission; } catch (error) { console.error(error); // Handle the error } } /* Promise resolves to: { "submission": { "formId": "21bcb6c7-02b3-4ed1-b6db-7856094fac03", "namespace": "wix.form_app.form", "status": "PENDING", "submissions": { "first_name": "Patsy", "last_name": "McBride" }, "revision": "1", "submitter": { "applicationId": "151e476a-715e-ec33-db9a-a7ff4d51f70a" }, "seen": false, "_id": "f8281b62-1b2f-45bf-ba7d-f041d7653d2d", "_createdDate": "2023-12-28T12:55:55.630Z", "_updatedDate": "2023-12-28T12:55:55.746Z" } } */
Errors
400Invalid Argument

There is 1 error with this status code.

404Not Found

There is 1 error with this status code.

428Failed Precondition

There are 2 errors with this status code.

503Unavailable

There is 1 error with this status code.

This method may also return standard errors. Learn more about standard Wix errors.

Did this help?