# Zoom Phone Batch Add Users API **URL:** \ **Category:** API and Webhooks\ **Tags:** api\ **Created:** [July 31, 2025, 3:56pm UTC](https://devforum.zoom.us/t/zoom-phone-batch-add-users-api/135904 "2025-07-31T15:56:26Z")\ **Posts on this page:** 12\ **Page:** 1
**Author:** ![dev.emily.garner](https://avatars.discourse-cdn.com/v4/letter/d/d6d6ee/32.png) [@dev.emily.garner](https://devforum.zoom.us/u/dev.emily.garner)\ **Post date:** [July 31, 2025, 3:56pm UTC](https://devforum.zoom.us/t/zoom-phone-batch-add-users-api/135904/1 "2025-07-31T15:56:26Z")
**API Endpoint(s) and/or Zoom API Event(s)** /phone/users/batch **Description** In the description of the API endpoint it says that the “outbound\_caller\_id” is not required and if left blank it will hide the caller ID, however when I try to actually call the endpoint without an outbound\_caller\_id it says “Outbound Caller ID is unavailable”. ```auto Error?{ “code”: 300, “message”: “Validation Failed.”, “errors”: [ { “index”: 0, “message”: “Outbound Caller ID is unavailable”, “field_name”: “outbound_caller_id” } ] } ``` ---
**Author:** ![elisa.zoom](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/elisa.zoom/32/47836_2.png) [@elisa.zoom](https://devforum.zoom.us/u/elisa.zoom)\ **Post date:** [August 1, 2025, 7:44pm UTC](https://devforum.zoom.us/t/zoom-phone-batch-add-users-api/135904/2 "2025-08-01T19:44:28Z")
Hi @dev.emily.garner Thanks for reaching out to us! Can you please share the entire request body you are sending so I can try and reproduce this on my end ---
**Author:** ![desautelsj](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/desautelsj/32/23584_2.png) [@desautelsj](https://devforum.zoom.us/u/desautelsj)\ **Post date:** [August 2, 2025, 2:29pm UTC](https://devforum.zoom.us/t/zoom-phone-batch-add-users-api/135904/3 "2025-08-02T14:29:25Z")
@dev.emily.garner I tried reproducing your scenario but I am unable to. I tried omitting the outbound caller id when batch creating a user and it completed successfully: ```auto REQUEST: POST https://api.zoom.us/v2/phone/users/batch {"users":[{"email":"","calling_plans":["US/CA Unlimited"],"extension_number":"803"}]} RESPONSE: HTTP/1.1 201 Created x-zm-trackingid: WEB_115631025b4cabde7cc79baba439acb0 [{"id":"6pVBBJUMSg-7Z2ZtPz3mww","email":""}] ``` I tried specifying a empty string ```auto REQUEST: POST https://api.zoom.us/v2/phone/users/batch {“users”:[{“email":"”,“calling_plans”:[“US/CA Unlimited”],“extension_number”:“803”,“outbound_caller_id”:“”}]} RESPONSE: HTTP/1.1 201 Created x-zm-trackingid: WEB_8bab5cf523e04f2245dbef857af59c46 [{“id":“6pVBBJUMSg-7Z2ZtPz3mww”,“email”:"”}] ``` I also tried specifying a null value ```auto REQUEST: POST https://api.zoom.us/v2/phone/users/batch {“users”:[{“email":"”,“calling_plans”:[“US/CA Unlimited”],“extension_number”:“803”,“outbound_caller_id”:null}]} RESPONSE: HTTP/1.1 201 Created x-zm-trackingid: WEB_cc8bd44459769891a37ed8fc903a2bd0 [{“id":“6pVBBJUMSg-7Z2ZtPz3mww”,“email”:"”}] ``` Maybe there’s something slightly different in the payload you submit to the API? ---
**Author:** ![dev.emily.garner](https://avatars.discourse-cdn.com/v4/letter/d/d6d6ee/32.png) [@dev.emily.garner](https://devforum.zoom.us/u/dev.emily.garner)\ **Post date:** [August 5, 2025, 3:25pm UTC](https://devforum.zoom.us/t/zoom-phone-batch-add-users-api/135904/4 "2025-08-05T15:25:43Z")
This is the full body (with certain data redacted): ```auto { “users”: [ { “email”: “email@outlook.com”, “first_name”: “Emily”, “last_name”: “LaFollette”, “calling_plans”: [ “US/CA Unlimited” ], “extension_number”: “1234”, “site_name”: “site name”, } ] } ``` ---
**Author:** ![desautelsj](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/desautelsj/32/23584_2.png) [@desautelsj](https://devforum.zoom.us/u/desautelsj)\ **Post date:** [August 6, 2025, 2:10pm UTC](https://devforum.zoom.us/t/zoom-phone-batch-add-users-api/135904/5 "2025-08-06T14:10:13Z")
I am still unable to reproduce, even when using the payload you just posted which leads me to think that something else must be at play (like an account setting, or something along those lines, for example). There’s a header called `x-zm-trackingid`in the response you get from the Zoom API. If you post the value of this header, maybe someone from Zoom’s engineering team can investigate their log an find more info about your situation. ---
**Author:** ![dev.emily.garner](https://avatars.discourse-cdn.com/v4/letter/d/d6d6ee/32.png) [@dev.emily.garner](https://devforum.zoom.us/u/dev.emily.garner)\ **Post date:** [August 12, 2025, 1:15pm UTC](https://devforum.zoom.us/t/zoom-phone-batch-add-users-api/135904/6 "2025-08-12T13:15:20Z")
@elisa.zoom This is the tracking ID: | WEB\_dd33e4b3ac0dcdd0e30dec82f3fd64aa | | --- | | | It is in our Dev account ---
**Author:** ![elisa.zoom](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/elisa.zoom/32/47836_2.png) [@elisa.zoom](https://devforum.zoom.us/u/elisa.zoom)\ **Post date:** [August 14, 2025, 5:49pm UTC](https://devforum.zoom.us/t/zoom-phone-batch-add-users-api/135904/7 "2025-08-14T17:49:05Z")
hey @dev.emily.garner Sorry for the late reply here. I am actually facing the same issue. When I pass ```auto { "users" : [ { "email": "elisalev@test.com", "first_name": "Elisa", "last_name": "Lev", "calling_plans": [ "US/CA Unlimited" ], "extension_number": "10", "site_name": "Main Site", } ] } ``` I get the outbound caller id error. I will escalate this with our Engineering team ( ZSEE-176244 internal ticket number for reference) @desautelsj I tried passing the request as you shared, and I could not either ---
**Author:** ![dev.emily.garner](https://avatars.discourse-cdn.com/v4/letter/d/d6d6ee/32.png) [@dev.emily.garner](https://devforum.zoom.us/u/dev.emily.garner)\ **Post date:** [August 21, 2025, 1:08pm UTC](https://devforum.zoom.us/t/zoom-phone-batch-add-users-api/135904/8 "2025-08-21T13:08:48Z")
Hi @elisa.zoom checking to see if there is any update on this ---
**Author:** ![elisa.zoom](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/elisa.zoom/32/47836_2.png) [@elisa.zoom](https://devforum.zoom.us/u/elisa.zoom)\ **Post date:** [August 21, 2025, 2:52pm UTC](https://devforum.zoom.us/t/zoom-phone-batch-add-users-api/135904/9 "2025-08-21T14:52:32Z")
Hi @dev.emily.garner I do have an update. I was informed that although it is not necessary to specify the outbound\_caller\_id, there is a prerequisite and it is that you must have a company number or site level outboud phone number. ![image](https://us1.discourse-cdn.com/flex016/uploads/zoomdeveloper/original/3X/d/6/d63e253534cb4912228cf68e1b603ed989ce031f.png) Can you please check this for me and try again ---
**Author:** ![dev.emily.garner](https://avatars.discourse-cdn.com/v4/letter/d/d6d6ee/32.png) [@dev.emily.garner](https://devforum.zoom.us/u/dev.emily.garner)\ **Post date:** [August 25, 2025, 2:36pm UTC](https://devforum.zoom.us/t/zoom-phone-batch-add-users-api/135904/10 "2025-08-25T14:36:46Z")
@elisa.zoom Yes, we have an auto receptionist assigned to the main site in our dev environment ---
**Author:** ![elisa.zoom](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/elisa.zoom/32/47836_2.png) [@elisa.zoom](https://devforum.zoom.us/u/elisa.zoom)\ **Post date:** [August 25, 2025, 3:19pm UTC](https://devforum.zoom.us/t/zoom-phone-batch-add-users-api/135904/11 "2025-08-25T15:19:23Z")
I’ll follow up with a DM for more information ---
**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:** [August 29, 2026, 6:55am UTC](https://devforum.zoom.us/t/zoom-phone-batch-add-users-api/135904/12 "2026-08-29T06:55:42Z")
Closed on August 29, 2026, 6:55am UTC This topic was automatically closed 368 days after the last reply. New replies are no longer allowed.