Track a user event

POST

https://uat-api.hastaai.in/api/v1/events/track

events

Last modified:2026-08-19 10:02:57

Log an in-app event, for logged-in AND logged-out users alike. Pass the event_name from the /lookup/core events list plus the client's device_id - events fire before login too (app_opened, onboarding, login CTA tapped), so device_id is what attributes the event, not the auth token.

Request: Bearer token optional - when present and valid, the event is also linked to that user_id; when absent/invalid, the event is still recorded against device_id alone.

Body: event_name (from /lookup/core), device_id

Success: 200 - returns { success, message } only (no data).

Errors: 404 - unknown event_name | 422 - missing fields

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Example

{
    "device_id": "BP22.250325.006",
    "event_name": "app_opened"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://uat-api.hastaai.in/api/v1/events/track' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "device_id": "BP22.250325.006",
    "event_name": "app_opened"
}'

Responses

🟢200OK

application/json

Successful Response

Bodyapplication/json

Example

{
    "success": true,
    "message": "Event tracked successfully"
}

🟠404Record Not Found

🟠422Parameter Error

Modified at 2026-08-19 10:02:57

Get all featured reviews

Fetch all tracked events