Field is mandatory despite the fact that documentation says it's deprecated when creating a Contact Center queue

The documentation for creating a Contact Center queue (see: Contact Center APIs) says that channel_types is deprecated and yet I get an error message if I omit this field.

In the following example, notice that I am specifying the ‘channel’ and omitting the ‘channel_types’:

REQUEST:
POST https://api.zoom.us/v2/contact_center/queues
{"queue_name":"ZoomNet Integration Testing","queue_description":"This queue is for testing purposes","channel":"voice"}

RESPONSE:
HTTP/1.1 400 Bad Request
Date: Sun, 21 Sep 2025 14:54:25 GMT
x-zm-trackingid: WEB_2aad42ac068489738c6c527cc4b76b99
{"code":1205,"message":"Queue channel type is invalid: null."}

If I issue a similar request but I specify the deprecated ‘channel_type’, my request completes successfully:

REQUEST:
POST https://api.zoom.us/v2/contact_center/queues
{"queue_name":"ZoomNet Integration Testing 2","queue_description":"This queue is for testing purposes","channel_types":["voice"]}

RESPONSE:
HTTP/1.1 201 Created
Date: Sun, 21 Sep 2025 15:05:25 GMT
x-zm-trackingid: WEB_fc431e327eb2805ca524bff824be1fef

{"queue_id":"ZWQ878AE750E230F5D298199FD7D6E42DA3","cc_queue_id":"IXeGa1cWQtS99XNJfo5aAw","queue_name":"ZoomNet Integration Testing 2","queue_description":"This queue is for testing purposes","channel_types":["voice"],"channel":"voice"}

To make matters even more confusing, the list of acceptable values for these two fields is slightly different.

It seems to me like there’s a discrepancy between what the documentation says and the actual API behavior.

Hi @desautelsj
Apologies for the delay here
I will take a look at this shortly

Hi @desautelsj
Have you tried passing the query param “channel” instead of the deprecated “channel_type” and see if the endpoint work as expected?

The first example I posted in my original comment shows what happens when I specify channel and omit channel_type. The response is HTTP 400 with this payload: {"code":1205,"message":"Queue channel type is invalid: null."}

Hi @desautelsj
I see now! Sorry, I missed that!
thanks! I will escalate this

Hi @desautelsj
I reported this and am waiting to hear back from our team (ZSEE-181479), internal ticket number for reference

1 Like