Migrating to the new external contacts feature in Zoom Phone
Zoom Phone now includes a dedicated space for managing shared External Contacts under
User Management. This new location lets admins organize contacts into groups and control which users can see which contacts using Shared Contact Lists — scoped to specific users, Zoom Phone sites, call queues, or common areas. If you previously managed external contacts under
Phone System Management, your contacts are already available in the new location with no re-import needed.
- Either a Zoom Workplace license with Phone included, or a standalone Zoom Phone calling plan
- Account owner or admin privileges with the External contacts permission enabled on your role
How to grant the external contacts permission
Note: Phone admins who previously managed external contacts in
Phone System Management will automatically have access to manage these external contacts.
- Sign in to the Zoom web portal as an account owner.
- In the navigation menu, click User Management then Roles.
- Click the relevant admin role.
- In the User and Permission Management section, find the External contacts row.
- Enable View and/or Edit as needed.
- Click Save.
How to add external contacts
- Sign in to the Zoom web portal.
- In the navigation menu, click User Management then External contacts.
- Click the Contacts tab.
- Click + Add external contact.
- Fill out the following information:
- Display name: Enter the name of the external contact as you want it to appear.
- Description (optional): Add notes or additional context to help identify the external contact.
- ID (optional): Enter a unique identifier for the external contact. If left blank, the system automatically generates an ID. When reimporting to update existing contacts, do not change the contact ID.
- Email (optional): Enter the external contact's email address.
- Extension number (optional): Enter an extension number to assign to this contact. Make sure the extension numbers are not duplicated with the existing ones in Zoom Phone.
- Phone number (optional): Enter the contact's phone number using standard E.164 format (e.g. +16992520210).
- Group (optional): Select one or more existing groups where the external contact will be added.
- Click Save.
How to import external contacts
- Sign in to the Zoom web portal.
- In the navigation menu, click User Management then External contacts.
- Click the Contacts tab.
- Click Import.
- Select one of the following:
- Add contacts to add new external contacts.
- Update contacts to update existing external contacts.
- Click CSV sample to view the requirements and click Download to save the template.
- Fill out the downloaded CSV file.
- Click Upload CSV to upload the CSV file.
How to export external contacts
- Sign in to the Zoom web portal.
- In the navigation menu, click User Management then External contacts.
- Click the Contacts tab.
- Click Export to download your complete external contact list as a CSV file.
How to add an external group
Groups let you organize related contacts so they can be added to one or more shared contact lists at once instead of individually.
- Sign in to the Zoom web portal.
- In the navigation menu, click User Management then External contacts.
- Click the Groups tab.
- Click + Add external group to create a group.
- Fill out the following information:
- Group name: Enter a display name for the group.
- Description (optional): Enter a description to help you identify the group.
- Click Save.
How to delete an external group
- Sign in to the Zoom web portal.
- In the navigation menu, click User Management then External contacts.
- Click the Groups tab.
- Click the ellipsis
next to the group name then click Delete. - Click Delete in the pop-up window to proceed.
How to rename an external group
- Sign in to the Zoom web portal.
- In the navigation menu, click User Management then External contacts.
- Click the Groups tab.
- Click the group name.
- In the top-right corner, click Edit.
- Edit the display name.
- (Optional) Edit the description.
- Click Save.
How to add members to an external group
- Sign in to the Zoom web portal.
- In the navigation menu, click User Management then External contacts.
- Click the Groups tab.
- Click the group name.
- Click + Add members.
- Search the member by name, email address, or ID.
Note: Only added external contacts can be searched and added to an external group. - Select the member.
- (Optional) Repeat steps 6 and 7 to add multiple members.
- Click Add.
How to control visibility with shared contact lists
Shared contact lists let you make specific external contacts visible only to specific users or Zoom Phone entities, such as sites, call queues, or common areas. Users with visibility will see the assigned contacts in their shared contact list in the Zoom Workplace app.
- Sign in to the Zoom web portal.
- In the navigation menu, click User Management then Contacts.
- Click Shared Contact Lists then + Add Shared Contact List.
- Enter a List Name.
- (Optional) Under Add Contacts, search for and select individual internal contacts or internal contact groups.
Note: Adding an existing internal contact to the shared contact list allows internal and external contacts to appear together in the same shared list. - Under Add External Contacts, search for then add individual external contacts or external contact groups.
- Under List Visibility, select one of the following:
- Anyone: Allows all users to view the shared contact list.
- Specific users, user groups or Zoom Phone entities: Restricts the shared contact list to selected users or groups.
- Search for then select one or more Zoom Phone users, user groups, sites, call queues, or common areas that will have access to these contacts.
- If one or more sites were selected, click the down arrow
next to each site and choose who within it should have access:
- All users in the site: Allows all site users to access the shared contact list.
- All members in all call queues: Allows all call queue members to access the shared contact list.
- All common areas: Allows all common area devices to access the shared contact list.
- Click Save.
Note: Any changes to the Zoom Phone site, such as users being added or removed, will automatically stay in sync with the list.