# Form Events

Events related to form display and submission.

## Form Start

- Event Name: `form-start`
- Triggered when a user is shown an entry form.

| Field | Type | Description | Required |
| --- | --- | --- | --- |
| timestamp | String (TimeStamp) | The timestamp of the event | Yes |
| pageTitle | String | The title of the page where the event occurred | Yes |
| hostName | String | The hostname of the page where the event occurred | Yes |
| pathName | String | The path of the page where the event occurred | Yes |
| queryString | String | The query string of the page where the event occurred | Yes |
| url | String | The URL of the page where the event occurred | Yes |
| referrer | String | The URL that linked to the page where the event occurred | Yes |
| languages | Array | The languages of the browser that made the request | Yes |
| userAgent | String | The user agent of the browser that made the request | Yes |
| siteId | String (GUID) | The ID of the hub where the event occurred | Yes |
| siteName | String | The name of the hub where the event occurred | Yes |
| userId | String (GUID) | The ID of the user that performed the action | Yes |
| contactId | String (GUID) | The ID of the contact that performed the action | Yes |
| cardId | String (GUID) | The ID of the card | Yes |
| cardType | String | The type of the card | Yes |
| cardSubType | String | The sub-type of the card | Yes |
| cardName | String | The name of the card | Yes |
| scope | String | Legacy property. The scope of the form. | Yes |

## Form Submission

- Event Name: `form-submission`
- Triggered when a user successfully submits an entry form.

| Field | Type | Description | Required |
| --- | --- | --- | --- |
| timestamp | String (TimeStamp) | The timestamp of the event | Yes |
| pageTitle | String | The title of the page where the event occurred | Yes |
| hostName | String | The hostname of the page where the event occurred | Yes |
| pathName | String | The path of the page where the event occurred | Yes |
| queryString | String | The query string of the page where the event occurred | Yes |
| url | String | The URL of the page where the event occurred | Yes |
| referrer | String | The URL that linked to the page where the event occurred | Yes |
| languages | Array | The languages of the browser that made the request | Yes |
| userAgent | String | The user agent of the browser that made the request | Yes |
| siteId | String (GUID) | The ID of the hub where the event occurred | Yes |
| siteName | String | The name of the hub where the event occurred | Yes |
| userId | String (GUID) | The ID of the user that performed the action | Yes |
| contactId | String (GUID) | The ID of the contact that performed the action | Yes |
| cardId | String (GUID) | The ID of the card | Yes |
| cardType | String | The type of the card | Yes |
| cardSubType | String | The sub-type of the card | Yes |
| cardName | String | The name of the card | Yes |
| scope | String | Legacy property. The scope of the form. | Yes |
| competitionEntryId | String (GUID) | The ID of the competition entry | Yes |