Track survey event

POST /api/v1/public/surveys/event/

Track survey interaction events such as survey opened, closed, or other user actions. Used for analytics and user behavior tracking.

Request body

Comparison table
FieldTypeRequiredDescription
survey_uuidstring (uuid)YesUUID of the survey the event belongs to.
session_uuidstring (uuid)NoSession the event belongs to (from the init response).
event_typesurvey_opened | survey_initialized | score_submitted | text_submitted | survey_closedYes

Code example

curl -X POST https://feedback.tools/api/v1/public/surveys/event \
  -H "Authorization: Bearer pk_..." \
  -H "Content-Type: application/json" \
  -d '{"survey_uuid":"<survey_uuid>","event_type":"survey_opened"}'

Responses

200 Success

Comparison table
FieldTypeRequired
survey_uuidstring (uuid)Yes
session_uuidstring (uuid)Yes

400 / 403 Error

Comparison table
FieldTypeRequired
detailstringYes
survey_uuidstring (uuid) | nullNo
session_uuidstring (uuid) | nullNo