Form Spam Submission Report Object


A form spam submission report stores a form submission that was flagged as spam, together with the reason it was flagged.

Reports are deleted automatically after 30 days, unless the submission is restored as not spam.

Properties
accessRestrictionstringformat GUIDimmutable

ID of the user who is authorized to view the original submission. Copied from the submission's accessRestriction.

When set, reading the report requires the same additional access check as reading the submission.


childMetaSiteIdstringRead-onlyformat GUID

ID of the site the submission was made on.

Returned only when the site shares its data with a parent site. In that case, spam submission reports from all child sites are stored on the parent site, and this field identifies which site the report came from.


contactIdstringRead-onlyformat GUID

ID of the contact who submitted the form: the site member who submitted it, or the contact matched to the submitter.


createdDatestringimmutableformat date-time

Date and time the original submission was created.

When you create a report for an existing submission, specify the submission's creation date to keep it. Can't be in the future.

Default: Date and time the report is created


extendedFieldsExtendedFields

Custom field data for the form spam submission report object.

Extended fields must be configured in the app dashboard before they can be accessed with API calls.


formIdstringformat GUIDimmutable

ID of the form the submission was made on.


idstringRead-onlyformat GUID

Form spam submission report ID.


namespacestringRead-onlyminLength 10maxLength 50

Namespace of the app that the form belongs to. Copied from the form.

Currently supports wix.form_app.form, the namespace of the Wix Forms app.


orderDetailsOrderDetails

Payment details of the submission.

Available only for forms with payments.


reportedDatestringRead-onlyformat date-time

Date and time the submission was reported as spam.


reportReasonstringimmutable

Reason the submission was flagged as spam.


reportReasonDescriptionstringminLength 1maxLength 255

Additional details about why the submission was flagged as spam. For example, the explanation returned by a spam moderation service plugin, or a note from the person who reported it.


revisionstringRead-onlyformat int64

Revision number, which increments by 1 each time the form spam submission report is updated.

Ignored when creating a form spam submission report.


submissionsMap <string, Value>immutableformat map

Submitted values. Each key is the target of a form field, and each value is what the submitter entered in that field.

Validated against the form's fields when the report is created.


submissionStatusAtReportstring

Status of the submission when it was reported as spam.

When the submission is restored as not spam, a PENDING status becomes CONFIRMED. Any other status is kept.

Returned as PENDING when the status wasn't recorded.


submitterSubmitterimmutable

Identity of the submitter: a member, visitor, app, or user.


updatedDatestringRead-onlyformat date-time

Date and time the form spam submission report was last updated.

Did this help?