Skip to main content
A participant joined event is sent when a participant joins a meeting.

Common fields

version
string
Represents the version of the event. Uses semantic versioning to inform a consumer if the payload has introduced any breaking changes.
type
string
Represents the type of the event described in the payload.
id
string
An identifier representing this specific event.
payload
object
An object representing the event, whose fields are described below.
event_ts
number
Documenting when the webhook itself was sent. This timestamp is different than the time of the event the webhook describes.

Payload

joined_at
number
The Unix epoch time in seconds representing when the participant joined.
session_id
string
The user session ID, or participant id.
room
string
The name of the room.
user_id
string
The ID of the user, set by the meeting token.
user_name
string
The name of the user, set by the meeting token.
owner
boolean
A flag determining if this user is considered the owner.
networkQualityState
string
The quality of the user’s network.
will_eject_at
number
The Unix epoch time in seconds representing when the participant will be ejected.
permissions
object
The permissions object, that describes what the participant is permitted to do during this call.
{
  "version": "1.0.0",
  "type": "participant.joined",
  "id": "ptcpt-join-6497c79b-f326-4942-aef8-c36a29140ad1-1708972279961",
  "payload": {
    "room": "test",
    "user_id": "6497c79b-f326-4942-aef8-c36a29140ad1",
    "user_name": "testuser",
    "session_id": "0c0d2dda-f21d-4cf9-ab56-86bf3c407ffa",
    "joined_at": 1708972279.96,
    "will_eject_at": 1708972299.541,
    "owner": false,
    "permissions": {
      "hasPresence": true,
      "canSend": true,
      "canReceive": { "base": true },
      "canAdmin": false
    }
  },
  "event_ts": 1708972279.961
}