WarmTransfer
webex calling · published

Webex Calling bulk provisioning in Control Hub

Verified 2026-09-25 · 55 sources · tier 2–4

Importing a Webex Calling CSV file causes the system to create, update, or delete associated elements depending on the field values in the file 29. WarmTransfer's reading of the sources is that Control Hub provides no single all-object Webex Calling import; bulk provisioning is instead split across separate per-object tools (such as user calling data, org-wide user CSV, devices, workspaces, numbers, call queues, hunt groups, auto attendants, and virtual lines), each with its own template, limits, and entry point, and most report through import history or the task manager 17.

CSV formatting and general conventions

If a mandatory field is missing from a record in a Webex Calling CSV import, that record is flagged for error 31. To clear a setting in an import, the administrator enters REMOVE in that column (the org-wide user CSV uses a different convention) 38. A blank cell means no change to the existing value 12.

Webex Calling CSV imports require dates in YYYY-MM-DD format 18. Microsoft Excel converts dates to MM/DD/YYYY when opening the file, and saving with that format causes the import to fail 18.

User provisioning

The org-wide Control Hub user CSV template, located at Users > Manage users by CSV, can add up to 20,000 users to an organization, though multiple CSV files must be uploaded and imported separately 42. This Control Hub user CSV no longer includes the UC Manager Profile, Calling Behavior, and Calling Behavior UC Manager Profile columns, as those settings are handled through a separate calling template 45.

Per-user calling features are managed through a separate CSV reached at Services > Calling > Service Settings > Manage User Calling Data 52. In this file, User Email is the only mandatory field, and all other fields are optional 49. Administrators preparing this CSV must not remove columns or headers, but may clear values in columns that should remain unchanged 30.

A Manage User Calling Data import is limited to 1000 records 51. When an export from this tool exceeds 1000 records, Control Hub downloads a ZIP file containing one CSV with the full data set and multiple CSV files of fewer than 1000 records each, ready for re-import 25. In Manage User Calling Data, the All Locations option in the location drop-down is disabled when an organization has more than 1000 calling users, requiring exports to be taken location by location 6. This is inferred: the documentation does not settle whether a Webex Calling user-data CSV may hold exactly 1000 records, because the user-data article states both "less than 1000" and "limited to 1000", while call queue and hunt group documentation specifies a maximum of 1,000 rows excluding the header 1.

Devices and workspaces

For Webex Calling devices, Cisco recommends at most 1000 devices per device CSV file, prepared from a recently generated template so workspace-license subscription data remains accurate 19. This limit is positioned as a recommendation rather than a hard cap 19.

Submitting a workspace CSV redirects administrators to the Control Hub task manager, which displays current and previous workspace jobs and provides a downloadable per-job error report 55.

Phone numbers

Control Hub can activate up to 500 inactive phone numbers at a time via Services > PSTN & Routing > Numbers 32. Bulk deletion of phone numbers is restricted to unassigned numbers 35. Furthermore, a phone number belonging to a block cannot be deleted unless every number in that block is unassigned 34.

Bulk number deletions and moves between locations execute as tasks in Control Hub Task Manager, where numbers that cannot be processed appear as errors 37.

Call queues, hunt groups, and auto attendants

A Webex Calling call queue CSV import may contain at most 1,000 rows, not counting the header 13. Call forwarding settings for a Webex Calling call queue cannot be modified in bulk through the CSV 16. A Webex Calling hunt group CSV import may contain at most 1,000 rows, not counting the header 26. Call forwarding settings for a Webex Calling hunt group cannot be modified in bulk through the CSV 28.

Object Maximum rows (excluding header) Bulk forwarding modifications
Call queue 1,000 13 Not permitted 16
Hunt group 1,000 26 Not permitted 28

Each row of a call queue CSV can include at most 50 agents 14. The agent action column accepts ADD, REMOVE, or REPLACE, with REPLACE overwriting all previously entered agents 14.

As of the article's 2025-12-12 update, the auto attendant bulk CSV could not delete whole auto attendants, create, modify, or delete call forwarding rules, or create new schedules, listing these capabilities as coming soon 4. As of its 2025-12-12 update, the auto attendant article listed exposing the bulk CSV operations as external APIs as coming soon 2.

Task tracking and APIs

Full administrators as well as user and device administrators can manage Control Hub tasks, including tracking the progress and errors of CSV imports 40. In task management, errors can be retrieved via Export errors to CSV 39. Active tasks can be stopped by clicking X and are accessible from the Background tasks running indicator 41. In the Manage User Calling Data interface, View Import history/tasks displays status and errors, generating an Error.csv file in real time independently of whether downloads complete 24.

Cisco positions Webex Calling provisioning APIs—spanning people, locations, organization settings, person calling settings, and workspace settings—as a mechanism to automate bulk provisioning, pointing developers toward the wxc_sdk Python SDK as a helper 11.

See also

See also Webex Calling administration APIs and scopes. See also Webex Calling Call Queue as a product. See also Webex Calling locations and number management.

Applicability

Applies to: Cisco Webex Calling, Cisco Control Hub, and Cisco Webex Calling APIs. Deployments: multi-tenant. Sources checked 2026-09-25.

What remains uncertain

Whether an auto attendant bulk CSV can now delete entire auto attendants, configure call forwarding rules, or create schedules beyond the state documented on 2025-12-12 is not covered by the sources below. Similarly, whether external APIs for bulk auto attendant CSV operations have been released is not covered by the sources below.

See also

Referenced by

  • Emergency callback numbers in Webex Calling — ECBN is settable per person/workspace/virtual line/location through the Emergency Services Settings APIs; topic id taken from the queued-topics directory listing and not otherwise verified

Sources

  1. 1
    The documentation does not settle whether a Webex Calling user-data CSV may hold exactly 1000 records. The user-data article says both 'less than 1000' and 'limited to 1000', while the call queue and hunt group articles say the maximum is 1,000 rows excluding the header.inferred
    Manage user calling data · Manage user calling data > import/export limits note; compare Configure Call Queue > CSV section · Checked 2026-09-25
  2. 2
    As of its 2025-12-12 update, the auto attendant article listed exposing the bulk CSV operations as external APIs as coming soon.
    Manage auto attendants · Manage auto attendants > bulk manage auto attendants section, coming-soon list · Checked 2026-09-25
  3. 3
    Webex Calling auto attendants are bulk managed by CSV from Services > Calling > Features > Auto Attendant through the bulk editor. Import status and errors appear under View Import history/Tasks.
    Manage auto attendants · Manage auto attendants > bulk manage auto attendants section · Checked 2026-09-25
  4. 4
    As of the article's 2025-12-12 update, the auto attendant bulk CSV could not delete whole auto attendants, create, modify or delete call forwarding rules, or create new schedules. The article lists these as coming soon.
    Manage auto attendants · Manage auto attendants > bulk manage auto attendants section, coming-soon list · Checked 2026-09-25
  5. 5
    Creating a new auto attendant by CSV requires, among others, Name, Phone Number or Extension, Location, Business Schedule, Holiday Schedule, the business-hours and after-hours no-input settings and actions, and at least one key-press entry for each of the two menus.
    Manage auto attendants · Manage auto attendants > auto attendant CSV field reference (mandatory for add) · Checked 2026-09-25
  6. 6
    In Manage User Calling Data, the All Locations option in the location drop-down is disabled when the organization has more than 1000 calling users, so exports must be made location by location.
    Manage user calling data · Manage user calling data > procedure step selecting a location · Checked 2026-09-25
  7. 7
    Besides Manage Numbers and Move Users, Webex Calling appears to expose asynchronous job APIs for rebuilding phones, device settings, call recording, updating a location's routing prefix and applying line key templates.inferred
    wxc_sdk.telephony.jobs module documentation · wxc_sdk.telephony.jobs > module class list · Checked 2026-09-25
  8. 8
    The Webex Calling Move Users job API appears to accept only one calling user per request.inferred
    wxc_sdk.telephony.jobs module documentation · wxc_sdk.telephony.jobs > MoveUsersJobsApi docstring · Checked 2026-09-25
  9. 9
    Starting a second move-number job while one is already running appears to be rejected with HTTP 409.inferred
    wxc_sdk.telephony.jobs module documentation · wxc_sdk.telephony.jobs > ManageNumbersJobsApi docstring · Checked 2026-09-25
  10. 10
    The Webex Calling Manage Numbers jobs API appears to support MOVE and NUMBER_USAGE_CHANGE operations, with up to 1000 numbers per request.inferred
    wxc_sdk.telephony.jobs module documentation · wxc_sdk.telephony.jobs > ManageNumbersJobsApi docstring · Checked 2026-09-25
  11. 11
    Cisco positions the Webex Calling provisioning APIs, covering people, locations, organization settings, person calling settings and workspace settings, as a way to automate bulk provisioning. It points developers to the wxc_sdk Python SDK as a helper.
    Calling APIs Overview · Calling APIs Overview > provisioning APIs section · Checked 2026-09-25
  12. 12
    In a Webex Calling CSV import, a blank cell means no change to the existing value.
    Bulk provisioning Webex Calling elements using CSV · Bulk provisioning Webex Calling elements using CSV > guidelines on blank cells · Checked 2026-09-25
  13. 13
    A Webex Calling call queue CSV import may contain at most 1,000 rows, not counting the header.
    Configure Call Queue · Configure Call Queue > bulk add and manage call queues (CSV) section · Checked 2026-09-25
  14. 14
    Each row of a Webex Calling call queue CSV can list at most 50 agents. The agent action column accepts ADD, REMOVE or REPLACE, and REPLACE overwrites all previously entered agents.
    Configure Call Queue · Configure Call Queue > call queue CSV field reference (Agent Action / Agents) · Checked 2026-09-25
  15. 15
    To add a call queue by CSV, the row must include Name, Location, Call Routing Pattern, and either a Phone Number or an Extension.
    Configure Call Queue · Configure Call Queue > call queue CSV field reference (mandatory for add) · Checked 2026-09-25
  16. 16
    Call forwarding settings for a Webex Calling call queue cannot be modified in bulk through the CSV.
    Configure Call Queue · Configure Call Queue > bulk add and manage call queues (CSV) section · Checked 2026-09-25
  17. 17
    Control Hub has no single all-object Webex Calling import. Bulk provisioning is split across separate per-object tools (user calling data, org-wide user CSV, devices, workspaces, numbers, call queues, hunt groups, auto attendants, virtual lines), each with its own template, limits and entry point, and most report through import history or the task manager.inferred
    Manage user calling data · Synthesis across ijda3o, n9r1aac, nlkiw8e, nef8r4l, wkj3f0, nzkg083, o6rfjeb, nsioxoi, nthc9kbb · Checked 2026-09-25
  18. 18
    Webex Calling CSV imports require dates in YYYY-MM-DD format. Microsoft Excel converts dates to MM/DD/YYYY when it opens the file, and a file saved with that format fails to import.
    Bulk provisioning Webex Calling elements using CSV · Bulk provisioning Webex Calling elements using CSV > date format note · Checked 2026-09-25
  19. 20
    Webex Calling IP phones are added in bulk from Control Hub Devices through Add device, choosing the multiple Cisco IP phones option and importing a CSV.
    Configure and manage Webex Calling devices · Configure and manage Webex Calling devices > add multiple devices section · Checked 2026-09-25
  20. 21
    In the bulk device CSV, leaving MAC Address blank generates an activation code instead. The codes can be delivered as a downloadable link in the CSV or by email to the user, or to the administrator for workspaces.
    Configure and manage Webex Calling devices · Configure and manage Webex Calling devices > add multiple devices section, CSV column table (MAC Address) and activation code delivery · Checked 2026-09-25
  21. 22
    The bulk device import offers three starting templates: one pre-filled with the organization's users, one pre-filled with its workspaces, and a blank sample template for manual entry.
    Configure and manage Webex Calling devices · Configure and manage Webex Calling devices > add multiple devices section, template options · Checked 2026-09-25
  22. 23
    In the bulk device CSV, the Phone Number and Extension columns are required only for rows of Type WORKSPACE.
    Configure and manage Webex Calling devices · Configure and manage Webex Calling devices > add multiple devices section, CSV column table · Checked 2026-09-25
  23. 24
    After a Manage User Calling Data import, View Import history/tasks shows the import status and any errors. The Error.csv file is generated in real time, independently of whether downloads complete.
    Manage user calling data · Manage user calling data > procedure final step (View Import history/tasks) · Checked 2026-09-25
  24. 25
    When a Webex Calling CSV export has more than 1000 records, Control Hub downloads a ZIP. It holds one CSV with the full data set plus multiple CSV files of fewer than 1000 records each, ready for re-import.
    Manage user calling data · Manage user calling data > import/export limits note · Checked 2026-09-25
  25. 26
    A Webex Calling hunt group CSV import may contain at most 1,000 rows, not counting the header.
    Manage hunt groups in Control Hub · Manage hunt groups in Control Hub > bulk add and manage hunt groups (CSV) section · Checked 2026-09-25
  26. 27
    In the Webex Calling hunt group CSV, the Agent Action and Alternate Numbers Action columns accept ADD, REMOVE or REPLACE, and each row holds at most 50 agents.
    Manage hunt groups in Control Hub · Manage hunt groups in Control Hub > hunt group CSV field reference · Checked 2026-09-25
  27. 28
    Call forwarding settings for a Webex Calling hunt group cannot be modified in bulk through the CSV.
    Manage hunt groups in Control Hub · Manage hunt groups in Control Hub > bulk add and manage hunt groups (CSV) section · Checked 2026-09-25
  28. 29
    Importing a Webex Calling CSV file causes the system to create, update or delete the associated elements depending on the field values in the file.
    Bulk provisioning Webex Calling elements using CSV · Bulk provisioning Webex Calling elements using CSV > body paragraph after intro · Checked 2026-09-25
  29. 30
    When preparing a Manage User Calling Data CSV, the administrator must not remove columns or headers but may clear values in columns that should stay unchanged.
    Manage user calling data · Manage user calling data > CSV guidelines · Checked 2026-09-25
  30. 31
    If a mandatory field is missing from a record in a Webex Calling CSV import, that record is flagged for error.
    Bulk provisioning Webex Calling elements using CSV · Bulk provisioning Webex Calling elements using CSV > guidelines on mandatory fields · Checked 2026-09-25
  31. 32
    Control Hub can activate up to 500 inactive phone numbers at a time from Services > PSTN & Routing > Numbers.
    Manage phone numbers in Control Hub · Manage phone numbers in Control Hub > activate phone numbers section · Checked 2026-09-25
  32. 33
    In Control Hub under Services > PSTN & Routing > Numbers > Manage > Add, an administrator can enter up to 1,000 phone numbers at once, separated by commas. Each number is validated as it is entered.
    Manage phone numbers in Control Hub · Manage phone numbers in Control Hub > add phone numbers section · Checked 2026-09-25
  33. 34
    A phone number that belongs to a block cannot be deleted unless every number in that block is unassigned.
    Manage phone numbers in Control Hub · Manage phone numbers in Control Hub > bulk delete phone numbers section · Checked 2026-09-25
  34. 35
    Only unassigned phone numbers can be deleted in bulk in Control Hub.
    Manage phone numbers in Control Hub · Manage phone numbers in Control Hub > bulk delete phone numbers section · Checked 2026-09-25
  35. 36
    The organization's phone numbers can be exported to a CSV file from Services > PSTN & Routing > Numbers > Manage > Export.
    Manage phone numbers in Control Hub · Manage phone numbers in Control Hub > export phone numbers section · Checked 2026-09-25
  36. 37
    Bulk phone number deletions and moves between locations run as tasks in Control Hub Task Manager, and numbers that cannot be processed show as errors there.
    Manage phone numbers in Control Hub · Manage phone numbers in Control Hub > bulk delete and move phone numbers sections · Checked 2026-09-25
  37. 38
    To clear a setting in a Webex Calling CSV import, the administrator enters REMOVE in that column.
    Bulk provisioning Webex Calling elements using CSV · Bulk provisioning Webex Calling elements using CSV > guidelines on clearing values · Checked 2026-09-25
  38. 39
    In Control Hub task management, errors from a task can be downloaded with Export errors to CSV.
    Manage tasks in Control Hub · Manage tasks in Control Hub > review task errors procedure · Checked 2026-09-25
  39. 40
    Full administrators and user and device administrators can manage Control Hub tasks, including reviewing the progress and errors of CSV imports.
    Manage tasks in Control Hub · Manage tasks in Control Hub > intro · Checked 2026-09-25
  40. 41
    An active Control Hub task can be stopped by clicking X. Running tasks are reachable from the Background tasks running indicator.
    Manage tasks in Control Hub · Manage tasks in Control Hub > stop an active task · Checked 2026-09-25
  41. 42
    The Control Hub user CSV template (Users > Manage users by CSV) can add up to 20,000 users to an organization. Multiple CSV files must be uploaded and imported separately.
    Manage multiple users in Control Hub with the CSV template · Manage multiple users in Control Hub with the CSV template > intro and import procedure · Checked 2026-09-25
  42. 43
    The Caller ID Number column in the Control Hub user management CSV must be in E.164 format.
    Control Hub user management CSV file reference · Control Hub user management CSV file reference > Caller ID Number row · Checked 2026-09-25
  43. 44
    When the Control Hub user CSV assigns services, a user whose row has no location fails to onboard.
    Manage multiple users in Control Hub with the CSV template · Manage multiple users in Control Hub with the CSV template > service assignment guidance · Checked 2026-09-25
  44. 45
    The Control Hub user CSV no longer includes the UC Manager Profile, Calling Behavior and Calling Behavior UC Manager Profile columns. Those settings are handled through a separate calling template.
    Manage multiple users in Control Hub with the CSV template · Manage multiple users in Control Hub with the CSV template > note on removed columns · Checked 2026-09-25
  45. 46
    In the Control Hub user management CSV, values such as Extension and Phone Number are removed by prefixing them with REMOVE|. This differs from the plain REMOVE keyword used in Webex Calling feature CSVs.
    Control Hub user management CSV file reference · Control Hub user management CSV file reference > Extension and Phone Number rows · Checked 2026-09-25
  46. 47
    In the Control Hub user CSV, entering TRUE in a service's column assigns that service's license to the user. Orgs using automatic license assignment should leave the service columns empty.
    Manage multiple users in Control Hub with the CSV template · Manage multiple users in Control Hub with the CSV template > service assignment guidance · Checked 2026-09-25
  47. 48
    Multi-value columns in the Manage User Calling Data CSV, such as authorization codes, monitoring lines, privacy users, push-to-talk users and attendant console entries, take ADD, REMOVE or REPLACE in their action column.
    Manage user calling data · Manage user calling data > CSV field reference table (action columns) · Checked 2026-09-25
  48. 49
    In the Manage User Calling Data CSV, User Email is the only mandatory field. All other fields are optional.
    Manage user calling data · Manage user calling data > CSV guidelines · Checked 2026-09-25
  49. 50
    The Manage User Calling Data CSV covers per-user calling features including voicemail, call forwarding, call waiting, caller ID, emergency callback, barge-in, call intercept, incoming and outgoing call permissions, call recording, hot desking, hoteling, monitoring, privacy, push to talk, receptionist client, attendant console, alternate numbers and music on hold.
    Manage user calling data · Manage user calling data > Download Data feature selection and CSV field reference · Checked 2026-09-25
  50. 51
    A Manage User Calling Data CSV import is limited to 1000 records.
    Manage user calling data · Manage user calling data > import/export limits note · Checked 2026-09-25
  51. 52
    The Webex Calling per-user feature CSV is reached in Control Hub at Services > Calling > Service Settings > Manage User Calling Data.
    Manage user calling data · Manage user calling data > procedure steps 1-3 · Checked 2026-09-25
  52. 53
    Webex Calling virtual lines can be added in bulk from Services > Calling > Virtual Lines, using Bulk Upload for the first upload and Manage > Upload CSV afterwards. The CSV needs first name, last name, display name, location, and a phone number and/or extension.
    Multi line support in Webex Calling using virtual lines · Multi line support in Webex Calling using virtual lines > bulk add virtual lines section · Checked 2026-09-25
  53. 54
    The workspace CSV Calling Type field accepts values including freeCalling, hybridCalling, webexCalling, webexEdgeForDevices, thirdPartySipCalling and none.
    Bulk upload workspaces using a CSV file · Bulk upload workspaces using a CSV file > CSV field descriptions (Calling Type) · Checked 2026-09-25
  54. 55
    After a workspace CSV is submitted, Control Hub redirects to the task manager, which shows current and previous workspace jobs and offers a downloadable per-job error report.
    Bulk upload workspaces using a CSV file · Bulk upload workspaces using a CSV file > after submitting the CSV · Checked 2026-09-25

Documents

tier 2 current vendor documentation

Bulk provisioning Webex Calling elements using CSV

Cisco Systems (Webex Help Center) · 2026-01-30 · accessed 2026-09-22

tier 2 current vendor documentation

Bulk upload workspaces using a CSV file

Cisco Webex Help Center · 2026-09-02 · accessed 2026-09-25

tier 2 current vendor documentation

Calling APIs Overview

Webex for Developers (Cisco) · 2022-10-31 · accessed 2026-09-25

tier 2 current vendor documentation

Configure and manage Webex Calling devices

Cisco Webex · 2026-09-01 · accessed 2026-09-25

tier 2 current vendor documentation

Configure Call Queue

Cisco Systems, Inc. (Webex Help Center) · 2026-07-23 · accessed 2026-09-16

tier 2 current vendor documentation

Control Hub user management CSV file reference

Cisco Webex Help Center · 2026-04-11 · accessed 2026-09-25

tier 2 current vendor documentation

Manage auto attendants

Cisco Systems, Inc. (Webex Help Center) · 2025-12-12 · accessed 2026-09-16

tier 2 current vendor documentation

Manage hunt groups in Control Hub

Cisco Systems, Inc. (Webex Help Center) · 2026-07-23 · accessed 2026-09-16

tier 2 current vendor documentation

Manage multiple users in Control Hub with the CSV template

Cisco Webex Help Center · 2026-09-03 · accessed 2026-09-25

tier 2 current vendor documentation

Manage phone numbers in Control Hub

Cisco Systems, Inc. (Webex Help Center) · 2026-07-23 · accessed 2026-09-15

tier 2 current vendor documentation

Manage tasks in Control Hub

Cisco Webex Help Center · 2026-07-10 · accessed 2026-09-25

tier 2 current vendor documentation

Manage user calling data

Cisco Webex Help Center · 2026-07-23 · accessed 2026-09-25

tier 2 current vendor documentation

Multi line support in Webex Calling using virtual lines

Cisco Systems · 2026-07-23 · accessed 2026-09-05

tier 4 archived vendor documentation

wxc_sdk.telephony.jobs module documentation

wxc_sdk project (Read the Docs) · 2026-09-25 · accessed 2026-09-25

Cite this page

APA

WarmTransfer. (2026, September 25). Webex Calling bulk provisioning in Control Hub. WarmTransfer. https://warmtransfer.net/knowledge/webex-calling-bulk-provisioning

BibTeX

@misc{warmtransfer-webex-calling-bulk-provisioning,
  title  = {Webex Calling bulk provisioning in Control Hub},
  author = {{WarmTransfer}},
  year   = {2026},
  url    = {https://warmtransfer.net/knowledge/webex-calling-bulk-provisioning},
  note   = {Verified 2026-09-25}
}