# Webhook participant left or join does not provide the customerKey field

**URL:** <https://devforum.zoom.us/t/webhook-participant-left-or-join-does-not-provide-the-customerkey-field/58924>\
**Category:** Feature Requests\
**Created:** [October 15, 2021, 9:52am UTC](https://devforum.zoom.us/t/webhook-participant-left-or-join-does-not-provide-the-customerkey-field/58924 "2021-10-15T09:52:52Z")\
**Posts on this page:** 2\
**Page:** 1

<div class="post-metadata">

**Author:** ![mariopulker](https://avatars.discourse-cdn.com/v4/letter/m/f04885/32.png) [@mariopulker](https://devforum.zoom.us/u/mariopulker)\
**Post date:** [October 15, 2021, 9:52am UTC](https://devforum.zoom.us/t/webhook-participant-left-or-join-does-not-provide-the-customerkey-field/58924/1 "2021-10-15T09:52:52Z")

</div>

**Description**  
We use webhooks to identify when a participant joined or left a meeting.  
Our participants join the meeting via the Meeting Web SDK (version 1.9.9).  
Normal participants will be registered for a meeting and on join we provide the “tk” and a “customerKey” field.  
A host is not registered and therefore the “tk” field is empty.  
But we provide the “customerKey” field.  
In the participant reports “{{baseUrl}}/report/meetings/:meetingId/participants” this “customerKey” is provided in the field “customer\_key”. So we can idenditfy the participant.  
In the participant webhooks this field is not provided.

**Error**  
Please provide the “customerKey” also in the participant webhooks to have a chance to identify the host.  
For registered participants the email and registrantId is provided.  
For a host nothing is provided for identification.

**Which App Type (OAuth / Chatbot / JWT / Webhook)?**  
Webhooks:

- Participant joined
- meeting.participant\_joined
- Participant left
- meeting.participant\_left

**Additional context**  
Here some examples what we can fetch from reports and what webhooks send.

Participant report data example:  
{{baseUrl}}/report/meetings/:meetingId/participants?page\_size=30  
Meeting ID: 93283599276

```auto
{
    "page_count": 1,
    "page_size": 30,
    "total_records": 2,
    "next_page_token": "",
    "participants": [
        {
            "id": "Tj8VWSXXXXX",
            "user_id": "XXXXX",
            "name": "Test User 1 (host)",
            "user_email": "",
            "join_time": "2021-10-15T08:53:27Z",
            "leave_time": "2021-10-15T08:54:17Z",
            "duration": 50,
            "attentiveness_score": "",
            "failover": false,
            "customer_key": "12345678"
        },
        {
            "id": "jNYB7RxRXXXXX",
            "user_id": "XXXXXX",
            "name": "Test User 2",
            "user_email": "testemail@ourdomain.com",
            "join_time": "2021-10-15T08:53:49Z",
            "leave_time": "2021-10-15T08:54:11Z",
            "duration": 22,
            "attentiveness_score": "",
            "failover": false,
            "customer_key": "6789901"
        }
    ]
}

```

Webhook participant left (host) payload data:

```auto
{
  account_id: 'XXXXXX',
  object: {
    uuid: 'XXXXXXX',
    participant: {
      leave_time: '2021-10-15T08:54:17Z',
      user_id: 'XXXXXX',
      user_name: 'Test User 1 (host)',
      registrant_id: '',
      id: 'Tj8XXXXXXX',
      leave_reason: 'left the meeting. Reason : Host ended the meeting.',
      email: ''
    },
    id: 'XXXXXXX',
    type: 2,
    topic: 'Test meeting for webhooks',
    host_id: 'XXXXX',
    duration: 10,
    start_time: '2021-10-15T08:53:27Z',
    timezone: 'America/Chicago'
  }
}

```

Webhook participant left (registered participant) payload data:

```auto
{
  account_id: 'XXXXXX',
  object: {
    uuid: 'XXXXXXX',
    participant: {
      leave_time: '2021-10-15T08:54:10Z',
      user_id: 'XXXXXX',
      user_name: 'Test User 2',
      registrant_id: 'XXXXXX',
      id: 'Fd1XXXXXXX',
      leave_reason: 'left the meeting',
      email: 'testemail@ourdomain.com'
    },
    id: 'XXXXXXX',
    type: 2,
    topic: 'Test meeting for webhooks',
    host_id: 'XXXXX',
    duration: 10,
    start_time: '2021-10-15T08:53:27Z',
    timezone: 'America/Chicago'
  }
}

```

It would be great if you can add to webhooks the field “customer\_key”.

---

<div class="post-metadata">

**Author:** ![system](https://us1.discourse-cdn.com/flex016/uploads/zoomdeveloper/original/3X/6/1/614bdd549b610bbaa46ff934617683a02bdaa03c.png) [@system](https://devforum.zoom.us/u/system)\
**Post date:** [November 14, 2021, 7:53pm UTC](https://devforum.zoom.us/t/webhook-participant-left-or-join-does-not-provide-the-customerkey-field/58924/2 "2021-11-14T19:53:14Z")

</div>

Closed on November 14, 2021, 7:53pm UTC

This topic was automatically closed 30 days after the last reply. New replies are no longer allowed.