---
title: "Set conversation events"
method: PUT
path: "/s2s/conversations/{conversationId}/events"
tags: ["S2S Conversations"]
---

# Set conversation events

`PUT /s2s/conversations/{conversationId}/events`

Attach an event log snapshot to the conversation — the same events
`Gleap.trackEvent()` buffers in the SDK flow and attaches when a
conversation is created. Scoped to this conversation only (not the
contact), so events from other sessions never mix in. Shown to agents in
the conversation's "Logs" panel. Each call replaces the previous snapshot
(max 500 events, 2 MB). Not delivered via webhooks or the stream.
For contact-level events that drive outbound rules, use
`POST /contacts/{userId}/events` instead.

## Path parameters

- `conversationId` string, required

## Request body

- S2SPutConversationEventsBody
  - `events` S2SConversationEventInput[], required — Snapshot of the events that led up to this conversation (max 500 entries, 2 MB). Replaces any previous snapshot for this conversation.
    - `name` string, required — Event name, e.g. "screen_opened" or "pageView".
    - `date` string — ISO timestamp of when the event happened; defaults to now.
    - `data` unknown

## Response `204`

No Content

## Changes

- **2026-09-03** `2d993d0c8a6e` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/gleap/apis/gleap-server/changes/s2s/conversations/:conversationId/events/put.md)

---

[API](https://skmtc.dev/gleap/apis/gleap-server.md) · [All operations](https://skmtc.dev/gleap/apis/gleap-server/llms.txt) · [OpenAPI document](https://skmtc.dev/gleap/apis/gleap-server/revisions/0a92e15c9803?raw)