Participant Joined

A participant joined event is sent when a participant joins a meeting.

Common fields

string

Represents the version of the event. Uses semantic versioning to inform a consumer if the payload has introduced any breaking changes.

string

Represents the type of the event described in the payload.

string

An identifier representing this specific event. In rare cases a duplicate delivery of this event carries a different id than the original, so deduplicate on the event type plus the payload’s session_id rather than on id. A session_id is unique to a single join, so a second participant.joined event for the same session_id is always a duplicate.

object

An object representing the event, whose fields are described below.

number

Documenting when the webhook itself was sent. This timestamp is different than the time of the event the webhook describes.

Payload

number

The Unix epoch time in seconds representing when the participant joined.

string

The user session ID, or participant id.

string

The name of the room.

string

The ID of the user. This is the user_id you set on their meeting token. If the participant joined without a meeting token, this field is left out of the payload. SIP and PSTN participants get this from their dial-in or dial-out setup instead.

string | null

The participant’s current name. It starts out as the user_name from their meeting token, or the userName call property if they joined without one, and if the name is changed later with setUserName() the webhook sends the new name. null when no name is set.

unknown

Any custom JSON data set for this participant, from the userData call property at join or from setUserData() later. It does not come from the meeting token. Left out of the payload when no user data is set.

boolean

A flag determining if this user is considered the owner.

string

Only sent for SIP and PSTN participants: one of sip-dial-in, sip-dial-out, pstn-dial-in, pstn-dial-out, or unknown. Regular web participants do not have this field.

number | null

The Unix epoch time in seconds representing when the participant will be ejected. null when no ejection is scheduled, which is the usual case.

object

The permissions object, that describes what the participant is permitted to do during this call.

{
  "version": "1.0.0",
  "type": "participant.joined",
  "id": "1-ptcpt-join-0c0d2dda-f21d-4cf9-ab56-86bf3c407ffa-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
}