Skip to main content
POST
Record a presentation event

Path Parameters

presentationId
string<uuid>
required

Body

application/json
_token
string
required

HMAC authentication token

type
enum<string>
required

Event type. action_detection and action_execution are deprecated: they are acknowledged but not stored.

Available options:
presentation_opened,
slide_viewed,
slide_viewed_batch,
cta_clicked,
action_detection,
action_execution
slideId
string
slideIndex
integer
durationMs
integer
skipped
boolean

Whether the viewer left the slide in under 2 seconds. A flag, not a filter: fast flips are still recorded as slide_viewed events.

views
object[]

Slide views to record in one request. Required when type is slide_viewed_batch. Each view counts against the rate limit individually.

Maximum array length: 25
ctaType
string
ctaLabel
string
ctaUrl
string

Destination URL of an external_link CTA. Send it only on cta_clicked events for that CTA type.

Response

Event recorded

success
boolean