Submission Created

Developer Preview

This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.

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.

Triggered when a submission is created.

Permissions

Learn more about app permissions.

Event BodyEvent Body Event data is received as a JSON Web Token (JWT). It may be delayed. Be sure to verify the data was sent by Wix.

Event Data

idstring

Unique event ID. Allows clients to ignore duplicate webhooks.

entityFqdnstring

Fully qualified domain name of the entity associated with the event. Expected wix.forms.v4.submission.

slugstring

Event name. Expected created.

entityIdstring

ID of the entity associated with the event.

eventTimestringformat date-time

Event timestamp.

triggeredByAnonymizeRequestboolean

Whether the event was triggered as a result of a privacy regulation application (for example, GDPR).

originatedFromstring

If present, indicates the action that triggered the event.

createdEventCreatedEvent

Event information.

Event Body

The data payload will include the following as an encoded JWT:

JSON


{
  "data": {
    "eventType": "wix.forms.v4.submission_created",
    "instanceId": "<app-instance-id>",
    "data": "<stringified-JSON>",
    // The identity field is sent as a stringified JSON
    "identity": {
      "identityType": "<identityType>", // ANONYMOUS_VISITOR, MEMBER, WIX_USER, APP
      "anonymousVisitorId": "<anonymousVisitorId>", // in case of ANONYMOUS_VISITOR
      "memberId": "<memberId>", // in case of MEMBER
      "wixUserId": "<wixUserId>", // in case of WIX_USER
      "appId": "<appId>" // in case of APP
    }
  }
}

Sample Data Shown:SubmissionCreated

JSON


{
  "id": "3bf9c9c1-6255-4e79-9019-29f08359596a",
  "entityFqdn": "wix.forms.v4.submission",
  "slug": "created",
  "entityId": "0ba57975-e4c4-46ba-87d8-1378c3d5b5d5",
  "createdEvent": {
    "entity": {
      "id": "0ba57975-e4c4-46ba-87d8-1378c3d5b5d5",
      "formId": "790b18dd-ee66-480b-a13d-69ebb0c2e23e",
      "namespace": "wix.form_app.form",
      "status": "CONFIRMED",
      "submissions": {
        "short_answer_d8fe": "a",
        "file_upload_2f0c": [
          {
            "fileId": "c8da58_ee12ce7b7e254af38b945d55a69ddda8~mv2.png",
            "displayName": "screen.png",
            "url": "https://static.wixstatic.com/media/c8da58_ee12ce7b7e254af38b945d55a69ddda8~mv2.png",
            "fileType": "image/png"
          }
        ]
      },
      "createdDate": "2023-06-15T07:55:04.701Z",
      "updatedDate": "2023-06-15T07:55:04.701Z",
      "revision": "1",
      "owner": { "visitorId": "c8da583d-b999-40a9-83e1-a1f8ccda31e8" },
      "submitter": { "visitorId": "c8da583d-b999-40a9-83e1-a1f8ccda31e8" },
      "seen": false
    }
  },
  "eventTime": "2019-10-30T17:22:10.299Z",
  "triggeredByAnonymizeRequest": false,
  "entityEventSequence": "1"
}

Did this help?