# API documentation does not match webhook payload - recording\_completed

**URL:** <https://devforum.zoom.us/t/api-documentation-does-not-match-webhook-payload-recording-completed/105696>\
**Category:** API and Webhooks\
**Created:** [March 13, 2024, 9:50pm UTC](https://devforum.zoom.us/t/api-documentation-does-not-match-webhook-payload-recording-completed/105696 "2024-03-13T21:50:59Z")\
**Posts on this page:** 6\
**Page:** 1

<div class="post-metadata">

**Author:** ![brad.close](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/brad.close/32/52941_2.png) [@brad.close](https://devforum.zoom.us/u/brad.close)\
**Post date:** [March 13, 2024, 9:50pm UTC](https://devforum.zoom.us/t/api-documentation-does-not-match-webhook-payload-recording-completed/105696/1 "2024-03-13T21:50:59Z")

</div>

During testing of our Zoom Contact Centre integration, we found that the contact\_center.recording\_completed does not include the “users” and “consumers” arrays in the webhook payload. These fields are shown in the API webhook documentation ([Contact Center Webhooks](https://developers.zoom.us/docs/contact-center/webhooks/#operation/contact_center.recording_completed)).

Is this a bug?

---

<div class="post-metadata">

**Author:** ![gianni.zoom](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/gianni.zoom/32/32523_2.png) [@gianni.zoom](https://devforum.zoom.us/u/gianni.zoom)\
**Post date:** [March 14, 2024, 4:11am UTC](https://devforum.zoom.us/t/api-documentation-does-not-match-webhook-payload-recording-completed/105696/2 "2024-03-14T04:11:10Z")

</div>

Hi @brad.close ,

I will follow up with docs. Can you please share a screenshot of what you’re seeing (with sensitive info obscured) please?

---

<div class="post-metadata">

**Author:** ![brad.close](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/brad.close/32/52941_2.png) [@brad.close](https://devforum.zoom.us/u/brad.close)\
**Post date:** [March 18, 2024, 3:44am UTC](https://devforum.zoom.us/t/api-documentation-does-not-match-webhook-payload-recording-completed/105696/4 "2024-03-18T03:44:33Z")

</div>

Hi @gianni.zoom. Thanks for the response.

Apologies for the slow reply; was waiting for the information to come back from the Developer. Here is a sample of the webhook payload we received (this is using a test set up, so I don’t know if it should be anonymised):

```auto
{
  "event" => "contact_center.recording_completed",
  "event_ts" => 1710723292512,
  "payload" => %{
    "account_id" => "TlpxuG1XQZyVpmdu3FCCNA",
    "object" => %{
      "channel" => "video",
      "channel_id" => "71z6Yr5oQwKTJarw+t3cEw==",
      "channel_type" => "video",
      "engagement_direction" => "inbound",
      "engagement_id" => "oRgjH2FJRqqErjTim6Uwug",
      "flow_id" => "lS7oQfRzTbq1dFzraKEb4w",
      "flow_name" => "IncomingVideo",
      "owner_id" => "ZWQ1659F6C6008337132175012A1E5C3620",
      "owner_name" => "Video",
      "owner_type" => "queue",
      "recording_duration" => 36,
      "recording_end_time" => "2024-03-18T00:54:52Z",
      "recording_id" => "QwhfHPSmTU24Wm-NYbJxJw",
      "recording_start_time" => "2024-03-18T00:50:50Z",
      "recording_type" => "automatic"
    }
  }
}

```

And this is the “List Engagement Recordings” response:

```auto
"recordings" : [
  %{
    "channel" => "video",
    "channel_type" => "video",
    "consumer_name" => "Customer",
    "consumer_number" => "",
    "consumers" => [%{"consumer_name" => "Customer", "consumer_number" => ""}],
    "direction" => "inbound",
    "display_name" => "<Display name>",
    "download_url" => "https://www.zoom.us/v2/contact_center/recording/download/QwhfHPSmTU24Wm-NYbJxJw?type=video",
    "engagement_id" => "oRgjH2FJRqqErjTim6Uwug",
    "flow_id" => "lS7oQfRzTbq1dFzraKEb4w",
    "flow_name" => "IncomingVideo",
    "owner_id" => "ZWQ1659F6C6008337132175012A1E5C3620",
    "owner_name" => "Video",
    "owner_type" => "queue",
    "playback_url" => "https://www.zoom.us/v2/contact_center/recording/playback/QwhfHPSmTU24Wm-NYbJxJw?type=video",
    "queue_id" => "ZWQ1659F6C6008337132175012A1E5C3620",
    "queue_name" => "Video",
    "recording_duration" => 36,
    "recording_end_time" => "2024-03-18T00:51:26Z",
    "recording_id" => "QwhfHPSmTU24Wm-NYbJxJw",
    "recording_start_time" => "2024-03-18T00:50:50Z",
    "recording_type" => "automatic",
    "transcript_url" => "https://www.zoom.us/v2/contact_center/recording/transcripts/download/QwhfHPSmTU24Wm-NYbJxJw?type=video",
    "user_email" => "<user_email>",
    "user_id" => "oP4byOOkQx2_G8j_hB0RzA"
  }
]

```

Please advise if this is as expected.

---

<div class="post-metadata">

**Author:** ![gianni.zoom](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/gianni.zoom/32/32523_2.png) [@gianni.zoom](https://devforum.zoom.us/u/gianni.zoom)\
**Post date:** [March 18, 2024, 9:53pm UTC](https://devforum.zoom.us/t/api-documentation-does-not-match-webhook-payload-recording-completed/105696/5 "2024-03-18T21:53:29Z")

</div>

Hi @brad.close ,

This is okay if it’s a test account. I have submitted this for review with our API team (ZSEE-122842)

---

<div class="post-metadata">

**Author:** ![gianni.zoom](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/gianni.zoom/32/32523_2.png) [@gianni.zoom](https://devforum.zoom.us/u/gianni.zoom)\
**Post date:** [March 22, 2024, 6:08pm UTC](https://devforum.zoom.us/t/api-documentation-does-not-match-webhook-payload-recording-completed/105696/6 "2024-03-22T18:08:29Z")

</div>

Hi @brad.close ,

Our team has discovered this is a bug and the ETA for the deployed fix is April 25 (ZOOM-691432).

---

<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:** [March 23, 2024, 6:09pm UTC](https://devforum.zoom.us/t/api-documentation-does-not-match-webhook-payload-recording-completed/105696/7 "2024-03-23T18:09:24Z")

</div>

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