# Updating contact by external ID

**URL:** <https://devforum.zoom.us/t/updating-contact-by-external-id/135009>\
**Category:** Phone\
**Tags:** phone, api\
**Created:** [July 9, 2025, 9:39am UTC](https://devforum.zoom.us/t/updating-contact-by-external-id/135009 "2025-07-09T09:39:35Z")\
**Posts on this page:** 4\
**Page:** 1

<div class="post-metadata">

**Author:** ![maxim.osipov](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/maxim.osipov/32/69535_2.png) [@maxim.osipov](https://devforum.zoom.us/u/maxim.osipov)\
**Post date:** [July 9, 2025, 9:39am UTC](https://devforum.zoom.us/t/updating-contact-by-external-id/135009/1 "2025-07-09T09:39:35Z")

</div>

@elisa.zoom In continuation of [Updating or searching external contacts with Zoom Phone API - #7 by elisa.zoom](https://devforum.zoom.us/t/updating-or-searching-external-contacts-with-zoom-phone-api/133938/7)

It doesn’t seem like the external contact ID can be used instead of the internally Zoom generated ID to update record.

The following sequence of calls fails:  
`curl -X POST -H "Content-Type: application/json" -H "Accept: application/json" -H "Authorization: Bearer ${ZOOM_ACCESS_TOKEN}" -d '{"id":"test-NNN", "name":"Test", "description":"Test", "phone_numbers":["+44xxxxxxxx"]}' https://api.zoom.us/v2/phone/external_contacts`

Returns `{"name":"Test","external_contact_id":"GENERATED_CONTACT_ID"}` where the `GENERATED_CONTACT_ID` is not `test-NNN`.

Update using the ID field `test-NNN`:  
`curl -X PATCH -H "Content-Type: application/json" -H "Accept: application/json" -H "Authorization: Bearer ${ZOOM_ACCESS_TOKEN}" -d '{"id":"test-NNN", "name":"Test", "description":"Test Patch", "phone_numbers":["+44xxxxxxxx"]}' https://api.zoom.us/v2/phone/external_contacts/test-NNN`

Fails with `{"code":300,"message":"Validation Failed.","errors":[{"field":"externalContactId","message":"External contact does not exist: test-NNN"}]}`

Update with the `GENERATED_CONTACT_ID` is successful.

---

<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:** [July 25, 2025, 3:55pm UTC](https://devforum.zoom.us/t/updating-contact-by-external-id/135009/3 "2025-07-25T15:55:02Z")

</div>

HI @maxim.osipov thanks for testing and sharing this. Based on the documentation, one would assume that the contact id passed by you during creation, would be useable in the update request.

However in the interim it seems it’s best to have a database that maps the zoom generated id to the external contact id you pass into Zoom.

@elisa.zoom if you tag me in the original internal thread, I am happy to follow up on this to determine if the endpoint is:

1. Supposed to also accept customer generated external id and
2. make a documentation change request for further clarity

---

<div class="post-metadata">

**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:** [July 28, 2025, 4:53pm UTC](https://devforum.zoom.us/t/updating-contact-by-external-id/135009/4 "2025-07-28T16:53:16Z")

</div>

Thanks for jumping in here @gianni.zoom

@maxim.osipov the external\_contact\_id can not be updated, the only one you can change and customize is the id field

---

<div class="post-metadata">

**Author:** ![maxim.osipov](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/maxim.osipov/32/69535_2.png) [@maxim.osipov](https://devforum.zoom.us/u/maxim.osipov)\
**Post date:** [July 29, 2025, 7:31am UTC](https://devforum.zoom.us/t/updating-contact-by-external-id/135009/5 "2025-07-29T07:31:53Z")

</div>

Thank you both for confirming that id field cannot be used to GET/PATCH the records. It unblocks or internal dev activity. Documentation clarification would be useful.
