LEVEL Agency
Measurement Docs

Event Reference (v1) / Form Events

Form Error form_error

Measures any errors within a forms lifecycle (validation, or otherwise).

  • Name
    Event Name Required
    Value
    event: form_error

Error Properties

These properties apply to all *_error events.

  • Name
    Error Code Optional
    Type
    error_code: integer|string
    Description

    The error code associated with the error event. Can be an HTTP status code (e.g. 404) or a custom error code depending on the situation.

  • Name
    Error Line Optional
    Type
    error_line: integer|string
    Description

    The line number and position in the code where the error occurred if the result of a thrown exception.

  • Name
    Error Message Optional
    Type
    error_message: string
    Description

    A human readable error message that describes the error.

Form Properties

These properties apply to all form_* events.

  • Name
    Form ID Required
    Type
    form_id: integer|string
    Description

    The unique identifier for the form. This can be as simple and as a HTML id attribute. Or it can be a native form ID from a CMS or other system.

    E.g.
    0d7fb0da-a3a6-49ad-9c29-d7fbcd56f3b1
  • Name
    Form Group Optional
    Type
    form_group: string
    Description

    The group or category of the form (e.g. Demo Request, or Webinar Registration). This can be used to group forms together for reporting purposes.

    E.g.
    Demo Request
  • Name
    Form Name Optional
    Type
    form_name: string
    Description

    A human readable name for the form. These should be dynamically set from the system that provides the form.

    E.g.
    Inbound Sales - Request a Demo
  • Name
    Form Provider Optional
    Type
    form_provider: string
    Description

    The name of the system/platform that provides the form (e.g. HubSpot, Marketo etc...). This can be useful when more than one form provider is in use (e.g. HubSpot and Gravity Forms).

    E.g.
    HubSpot

© 2026 Level Agency.