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<CreateSubmissionResponse>;
Method Parameters
submissionFormSubmissionRequired

Submission to create.


optionsCreateSubmissionOptions

Optional fields.

Returns
Return Type:Promise<CreateSubmissionResponse>
JavaScript
import { submissions } from "wix-forms.v2"; /* 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

This method doesn’t return any custom errors, but may return standard errors. Learn more about standard Wix errors.

Did this help?