curl https://api.pushnotif.ai/v1/events \
-H "Authorization: Bearer pna_..." \
-H "Content-Type: application/json" \
-d '{
"device": {
"install_id": "6f1c...",
"timezone": "America/New_York"
},
"events": [{
"event_id": "0b8e2f4a-...",
"name": "quiz_finished",
"properties": { "score": 92, "passed": true },
"occurred_at": "2026-11-03T15:04:05Z"
}]
}'
{ "accepted": 1, "duplicates": 0 }
Ingest API
Send events
Record a batch of events from one device.
POST
/
v1
/
events
curl https://api.pushnotif.ai/v1/events \
-H "Authorization: Bearer pna_..." \
-H "Content-Type: application/json" \
-d '{
"device": {
"install_id": "6f1c...",
"timezone": "America/New_York"
},
"events": [{
"event_id": "0b8e2f4a-...",
"name": "quiz_finished",
"properties": { "score": 92, "passed": true },
"occurred_at": "2026-11-03T15:04:05Z"
}]
}'
{ "accepted": 1, "duplicates": 0 }
Events are stored and acknowledged right away. Flows evaluate them shortly
after, so a
202 means “safely stored”, not “flows have run”.
Body
object[]
required
Up to 500 events.
Show event
Show event
string
required
Your unique id for this event, at most 128 characters. Sending the same
id again is counted as a duplicate, not a second event, so retries are
safe.
string
required
At most 128 characters. Names starting with
$ are reserved.object
Any JSON object, at most 32 KB. Types are kept exactly as sent: a flow
comparing
score >= 80 matches 80, not "80".string | number
required
ISO 8601 string or epoch milliseconds. A time in the future is clamped to
now.
string
sandbox for development builds, production otherwise. Lets the
dashboard separate your own test traffic from real users.Response
number
Events newly stored.
number
Events whose
event_id was already stored, and so ignored.curl https://api.pushnotif.ai/v1/events \
-H "Authorization: Bearer pna_..." \
-H "Content-Type: application/json" \
-d '{
"device": {
"install_id": "6f1c...",
"timezone": "America/New_York"
},
"events": [{
"event_id": "0b8e2f4a-...",
"name": "quiz_finished",
"properties": { "score": 92, "passed": true },
"occurred_at": "2026-11-03T15:04:05Z"
}]
}'
{ "accepted": 1, "duplicates": 0 }