POST

Create Submission


Note: The Form Submission API only works with the Wix Forms app. Call GetAppInstance to confirm that the app named wix_forms is installed on the site.


Creates a new submission.

Permissions
Manage Challenges
Manage Submissions
Manage form submissions.
Learn more about app permissions.
Endpoint
POST
https://www.wixapis.com/form-submission-service/v4/submissions

Body Params
submissionSubmissionRequired

Submission to create.


captchaTokenstringminLength 1maxLength 3000

Captcha token.

Response Object
submissionSubmission

The created submission.

Create Submission Example 1
Request
cURL
curl -X POST \ 'http://www.wixapis.com/form-submission/v4/submissions' \ -H 'Content-Type: application/json' \ -H 'Authorization: <AUTH>' \ -d '{ "submission": { "formId": "e62e3011-55cf-4de3-a497-e097b52d86b8", "submissions": { "first_name": "Adam", "last_name": "Fisher" } } }'
Response
JSON
{ "submission": { "id": "e62e3011-55cf-4de3-a497-e097b52d86b7", "formId": "e62e3011-55cf-4de3-a497-e097b52d86b8", "namespace": "wix.form_app.form", "status": "PENDING", "submissions": { "first_name": "Adam", "last_name": "Fisher" }, "submitter": { "memberId": "4b42fb49-8c77-4128-859c-8247756f68ef" }, "seen": false, "revision": 1, "createdDate": "2019-10-30T17:22:10.299Z", "updatedDate": "2019-10-30T17:22:10.299Z" } }
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.

Event TriggersThis method triggers the following events:
Did this help?