Track survey event
POST /api/public/v2/surveys/{survey_uuid}/events/
Track survey interaction events such as survey opened, closed, or other user actions. Used for analytics and user behavior tracking.
Path parameters
Comparison table| Parameter | Type | Required | Description |
|---|
survey_uuid | string (uuid) | Yes | UUID of the survey. |
Request body
Comparison table| Field | Type | Required | Description |
|---|
session_uuid | string (uuid) | null | No | Optional. Session the event belongs to (from the session response). Omit or send null to start a fresh session. |
event_type | survey_opened | score_submitted | text_submitted | survey_closed | Yes | |
Code example
curl -X POST https://feedback.tools/api/public/v2/surveys/<survey_uuid>/events \
-H "Authorization: Bearer pk_..." \
-H "Content-Type: application/json" \
-d '{"event_type":"survey_opened"}'
Responses
200 Success
Comparison table| Field | Type | Required |
|---|
survey_uuid | string (uuid) | Yes |
session_uuid | string (uuid) | Yes |
400 / 403 Error
Comparison table| Field | Type | Required |
|---|
detail | string | Yes |
survey_uuid | string (uuid) | null | No |
session_uuid | string (uuid) | null | No |
