Send a new user event

Changed on

Required: event_name, event_value, quiz_id. For the event to be counted in Analytics (funnels, conversion), send the numeric quiz ID in quiz_id. The legacy quiz field is deprecated and ignored. The event is attached to the user's latest visit unless user_visit_id is passed (see /user/user_visit).

post/user/events

Request

  • Base URL
    https://api.web2wave.com/api
  • URL
    https://api.web2wave.com/api/user/events
  • Auth
    API key in header api_key

Query parameters

userstring required

Email or user GUID

Request body

event_namestring
event_valuestring
dtstring date-time
event_propertiesobject
urlstring
initial_urlstring
user_agentstring
user_timestring
user_timezonestring
user_localestring
user_idstring
projectstring
app_versionstring
quizstring
quiz_versionstring
ab_teststring
project_idstring
quiz_idinteger

Quiz ID (required); must belong to the project.

user_visit_idstring

Optional visit to attach the event to; defaults to the user's latest visit.

Response

User event created successfully

Changes

    • breaking

      added subschema #2 to the request body allOf list

    • breaking

      the request's body type changed from object to no type

    • warning

      removed the request property

    • warning

      removed the request property

    • warning

      removed the request property

    • warning

      removed the request property

    • warning

      removed the request property

    • warning

      removed the request property

    • warning

      removed the request property

    • warning

      removed the request property

    • warning

      removed the request property

    • warning

      removed the request property

    • warning

      removed the request property

    • warning

      removed the request property

    • warning

      removed the request property

    • warning

      removed the request property

    • warning

      removed the request property

    • warning

      removed the request property

    • warning

      removed the request property

    • warning

      removed the request property

    • info

      added the non-success response with the status

    • info

      removed the non-success response with the status