How to Display First Name for Mobile Users in Zoom Video SDK Web Toolkit When Username Contains UserID

Video SDK
1

Hi @vic.yang and @ekaansh.zoom
One more query I have that, I want to display the first name of members who joined from mobile devices in the Zoom Web SDK using the version zoom/videosdk-ui-toolkit:2.2.0~1. Currently, users joining from mobile have their userId assigned to the username field because the backend requires the userId to track them via webhooks.

Is there a way to pass an additional key or property when joining from mobile that contains the user’s real name? Mainly, I want to automatically edit and display only the first name of the member in the web SDK when they join, even though the username field contains the userId.

Could you please suggest the best practice or key to use for sharing this information, and how to modify the displayed name to show the first name of the mobile user upon automatic join?

2

Hi @Rahul13 You could pass their into the user_key field in the jwtToken request payload.

3

Hi @ticorrian.heard
We’re currently facing an issue where we need to pass and retrieve the user ID (from our database) of participants—whether they join via web or mobile. We’ve attempted to include the user ID in the JWT token, but we’re unable to retrieve it in the webhooks, which prevents us from accurately mapping who joins a session. Our goal is to receive a ID (host or attendee) which we have in our database via webhooks. Right now, we’re using a name-ID combination in the userName while join, but this requires DOM manipulation on the frontend to extract IDs, which is insecure and not best practice. We’re using zoom/videosdk-ui-toolkit-2.2.0~1 on web and zoom/react-native-videosdk on mobile. Additionally, the UI toolkit doesn’t seem to provide an event or method to modify or filter participant names based on our needs. We’re looking for a secure, reliable way to pass and access user-specific identifiers in webhooks—please advise if there’s a supported approach.

4

@Rahul13 What webhooks are you using for this use case?

The user.joined and user.left webhooks include the user_key in their request payload.

5

Hi @ticorrian.heard

I have add the user_key in JWT token and after decode i can check that the user_key there but when the web hook call user.joined and user.left I received this kind of response
{
account_id: “7hyyK79DSqmiOm6I36ZpRw”,
object: {
session_id: “L/GzI/48S56CULjpx7NS7g==”,
id: “L/GzI/48S56CULjpx7NS7g==”,
user: {
leave_time: “2025-06-26T07:48:33Z”,
name: “Rahul Grover”,
id: “16778240”,
leave_reason: “left the meeting. Reason : Host ended the meeting.”,
participant_uuid: “25798D7E-FB82-CAB7-5243-0D008A34BC2D”,
},
session_name: “teshhh-c12f81a6-d10c-4544-84c2-cd09de3395f0”,
},
}
Here I don’t receive any user_key

6

As I am using the latest version of the webhook in the backend, I found that the user_identity is not provided. When the webhook is triggered, there is no token available from which we can extract it. If I were able to access the token, I could retrieve the user_key. Can you please suggest a solution for this?