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.
function createSubmission(
submission: FormSubmission,
options: CreateSubmissionOptions,
): Promise<CreateSubmissionResponse>;
Submission to create.
Optional fields.
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"
}
}
*/
This method doesn’t return any custom errors, but may return standard errors. Learn more about standard Wix errors.