Webex Contact Center bulk operations imports and export jobs
Verified 2026-09-22 · 60 sources · tier 2 · 2 disputed
Also known as Bulk Operations.
Bulk Operations in Webex Contact Center enables administrators to create, modify, import, or export tenant configuration objects 37. It is accessed in Control Hub at admin.webex.com under Services, Contact Center, Tenant Settings, Bulk Operations 31.
How it works
Bulk Operations can create and edit configuration objects, but it cannot delete configuration objects 32. The system matches on the Name column: if an object name already exists, the record is updated from the CSV row, and if it does not exist, a new object is created 52. WarmTransfer's reading of the sources is that Address Book, Outdial ANI, and Skill Profile CSVs carry an optional Delete column that removes an individual child entry rather than the parent configuration object 7.
Only 1 bulk operation can be active at a time in a Webex Contact Center tenant 34. A Bulk Operations CSV request can process a maximum of 5000 rows, and larger data sets must be split across multiple files and multiple requests 41. Webex Contact Center rejects any bulk operations CSV file that contains more than 5000 rows 42. Sources disagree on the maximum CSV file size: the Bulk Operations article states that Bulk Operations cannot process CSV files larger than 5 MB 6, whereas the CSV definition article states that the maximum size limit for a bulk operations CSV file is 10 MB 5.
Audio files are imported through Bulk Operations as a ZIP archive, and Webex Contact Center supports only WAV format for those files 3. The maximum supported size for an audio-file ZIP archive submitted to Bulk Operations is 50 MB 60. Audio files for agent personal greetings and compliance messages must be WAV, mono, 8 kHz sample rate, and 8-bit u-law encoded 2.
A Bulk Operations job reports 1 of 5 statuses: New, In Progress, Completed, Completed with errors, or Failed 23. Jobs remain accessible for 1 year 22. When a job finishes with errors, the administrator can export the errors to CSV to see the per-record failure reasons and resubmit the corrected records 14.
Import and export procedures
The documented method to bulk-update existing configuration is to run an export job, download the export file, edit the rows in that CSV, and import it again 16. An export job is submitted by clicking Create Bulk Operation, selecting the configuration object type, entering a filename under Export, clicking Next, and downloading the file once the job completes 15. For skill profile administration, administrators are directed to this export procedure to bulk download configured profiles 48.
An import job is submitted by clicking Create Bulk Operation, selecting the configuration object type, browsing to and uploading the CSV file, and clicking Next 21. Bulk Operations provides a downloadable sample template containing the correct CSV headers for the selected configuration object type 50.
CSV formatting rules and object types
The first row of a bulk operations CSV file is the header row, and a comma separates field values 18. In the bulk operations CSV definitions, all column values are mandatory unless explicitly marked otherwise 30.
The CSV definition article documents column requirements for configuration object types 17:
| Object Type | Required Columns | Optional Columns |
|---|---|---|
| Global Variables | Name, Variable Type, Default Value 17 | Description, Agent Editable, Agent Viewable, Reportable, Desktop Label 17 |
| Skill Definition | Name, Service Level Threshold, Type, List Values For Enum (when Type is ENUM) 44 | Description 44 |
| Skill Profile | Name, Skill Name, Skill Values 46 | Description, Delete 46 |
| Queue Child Rows | Name, Distribution Group Seq, Group Fallback Time, Group Teams 38 | |
| User | Email, User Profile, Contact Center Enabled 53 | Site, Teams, Skill Profile, Desktop Profile, Multimedia Profile, External Id, Default DN 53 |
| Team | Name, Site, Type 49 | Multimedia Profile, Skill Profile, DN, Capacity, Desktop Layout 49 |
| Site | Name, Multimedia Profile 43 | |
| Entry Point | Name, Service Level Threshold, Timezone, Channel Type 12 | Description, Social Channel Type, Asset Name 12 |
| Entry Point Mappings | Dialed Number, Entry Point, Region 13 | |
| Holiday Lists | Name, Holiday Name, Start Date, End Date 19 | Description 19 |
| Working Hours | Name, Timezone, Shift Name, Days of Week, Start Time, End Time 55 | Description, Holiday List, Overrides 55 |
| Overrides | Name, Timezone, Override Name, Start Datetime, End Datetime, Enabled 36 | Description 36 |
| Dial Plans | Name, Regular Expressions 9 | Prefix, Stripped Chars 9 |
| Desktop Layouts | Name, Team Names, JSON File 8 | Descriptions, Zipped JSON File 8 |
| Call Recording Schedules | Name, Queue Name, Start Date, End Date, Days of Week, Start Time, End Time, Active, Enable Pause Resume, Percentage, Filter By Sites, Filter By Teams, Filter By Agents, Stop Recording for Transferred 40 | Pause Duration 40 |
| Threshold Rules | Name, Operand, Entity Type, Entity Name, Metric Type, Threshold Metric, Trigger Interval, Trigger Value 51 | Description, Notification Receivers, Text Notification Receivers 51 |
| Worktype | Name, Type 56 | Description 56 |
| Auxiliary Code | Name, Default, Work Type 56 | Description 56 |
A skill definition must already exist before that skill can be assigned to a skill profile through bulk operations 45. In the Skill Profile CSV, the profile serves as the parent row and each skill is a subsequent child row; skills not mentioned during an update remain unchanged on the profile 47. Conversely, when a queue or its call distribution groups are updated by bulk operations, the CSV must include the full queue definition with all distribution groups in parent-child form, and that definition overwrites the existing queue definition 39.
System limits and scale
Tenant capacity caps define upper bounds for bulk imports:
- 9000 skill profiles per tenant and 50 skills per skill profile 26.
- 1000 active skills per tenant 27.
- 20000 active users, 300 active sites, and 3000 agent-based teams per tenant 28.
- 3000 address books, 6000 entries per address book, and 100000 address book entries in total 24.
- 400 Outdial ANI lists, 200 entries per list, and 2000 Outdial ANI entries in total 25.
WarmTransfer's reading of the sources is that reaching tenant object caps exceeding 5000 requires several serialized bulk jobs, because an individual bulk job is capped at 5000 rows and only 1 job runs at a time 11.
Platform differences and documentation
The Webex Contact Center documentation index lists both the Bulk Operations article and the CSV definition article under a Bulk Operations in Webex Contact Center section 10. WarmTransfer's reading of the sources is that help centre article na01x6o returns the same Bulk Operations body text and printed date as article 31e39g 1.
Bulk Operations in Webex Contact Center differs from capabilities in related Cisco calling and contact center offerings:
- The Bulk Update Users, Bulk Skilling, and Bulk Password Reset features announced for August 2026 belong to the Webex Contact Center Enterprise Administration Portal rather than Control Hub Bulk Operations 58. Webex Contact Center Enterprise Bulk Update Users supports Agent Team, Profile, Agent Services, Digital Support Channel, Site, Location, and Enterprise Name 59.
- Webex Calling bulk CSV provisioning is a separate Control Hub facility that can create, update, or delete elements based on field values 57.
Applicability
Applies to: Cisco Webex Contact Center, Cisco Webex Contact Center Enterprise, and Cisco Webex Calling. Deployments: multi-tenant. Sources checked 2026-09-22. The Webex Contact Center Enterprise features apply to the August 2026 release 58.
What remains uncertain
Whether a public REST API exists to submit bulk config import or export jobs is not covered by the sources below.
Sources disagree on the CSV size limit, which is cited as 5 MB in the Bulk Operations article 6 and 10 MB in the CSV definition article 5.
Whether the UCCX to Webex Contact Center migration guides prescribe an import order for Bulk Operations is not covered by the sources below.
The authoritative list and total count of supported bulk operations object types are not covered by the sources below.
Whether an uploaded row that would breach a tenant system limit fails only that individual row or the entire job is not covered by the sources below.
The Control Hub role or user profile privilege required to perform Bulk Operations is not covered by the sources below.
Whether bulk operations jobs are recorded in the Control Hub audit or activity log is not covered by the sources below.
Detailed documentation for Webex Contact Center Enterprise Bulk Update Users and Bulk Skilling features beyond the listed attributes is not covered by the sources below.
See also
Affects
- Webex Contact Center system limits reference — Bulk imports are the way an organisation approaches these caps
Referenced by
- The UCCX to Webex Contact Center discovery tool — The discovery tool produces nothing that Webex Contact Center consumes directly. Its WebexCC_Bulk_Upload.zip is imported through Bulk Operations; so the Bulk Operations limits (5000 rows per CSV request; 50 MB audio ZIP; no audio export) are the real ceiling on what the tool can deliver in one pass.
- UCCX to Webex Contact Center migration — Every configuration object this guide loads arrives through Control Hub Bulk Operations CSV jobs.
- Troubleshooting Webex Contact Center users that do not appear as agents — Bulk Operations update Contact Center attributes of existing licensed users; row and file-size limits apply
- UCCX objects and their Webex Contact Center equivalents — The CSV definitions for bulk operations are the authoritative field-level contract that the crosswalk targets.
- UCCX scripts and Flow Designer flows — Bulk Operations loads the queues; entry points; teams; skills and audio files that a redesigned flow references; but flows are not a Bulk Operations object type.
Sources
- 1Help centre article na01x6o returns the same Bulk Operations body text and the same printed date as article 31e39g.inferredBulk Operations in Webex Contact Center (alternate article id na01x6o) · whole document, compared against article 31e39g · Checked 2026-09-22
- 2Audio files for agent personal greetings and compliance messages must be WAV, mono, 8 kHz sample rate and 8-bit u-law encoded.Enhance efficiency with pre-recorded messages · sections: Agent Personal Greetings and Compliance Messages, audio format note · Checked 2026-09-22
- 3Audio files are imported through Bulk Operations as a ZIP archive, and Webex Contact Center supports only WAV format for those audio files.Bulk Operations in Webex Contact Center · section: Overview of Bulk Operations, audio files · Checked 2026-09-22
- 4The Set up business hours article does not mention Bulk Operations or CSV import of working hours, holiday lists or overrides, even though those object types have bulk CSV definitions.inferredSet up business hours for Webex Contact Center · whole document, keyword sweep for bulk and CSV · Checked 2026-09-22
- 5The CSV definition article states that the maximum size limit for a bulk operations CSV file is 10 MB.disputedCSV definition for bulk operations in Webex Contact Center · section: intro, CSV file rules bullet list · Checked 2026-09-22
- 6The Bulk Operations article states that Bulk Operations cannot process CSV files larger than 5 MB.disputedBulk Operations in Webex Contact Center · section: Overview of Bulk Operations, CSV limits · Checked 2026-09-22
- 7Address Book, Outdial ANI and Skill Profile CSVs carry an optional Delete column that removes an individual child entry rather than the parent configuration object.inferredCSV definition for bulk operations in Webex Contact Center · sections: Address Book, Outdial ANI, Skill Profile; Delete column descriptions · Checked 2026-09-22
- 8The Desktop Layouts CSV requires Name, Team Names and JSON File, with Descriptions and Zipped JSON File optional.CSV definition for bulk operations in Webex Contact Center · section: Desktop Layouts, CSV column table · Checked 2026-09-22
- 9The Dial Plans CSV requires Name and Regular Expressions, with Prefix and Stripped Chars optional.CSV definition for bulk operations in Webex Contact Center · section: Dial Plans, CSV column table · Checked 2026-09-22
- 10The Webex Contact Center documentation index lists both the Bulk Operations article and the CSV definition article under a Bulk Operations in Webex Contact Center section.Webex Contact Center Documentation · section: Bulk Operations in Webex Contact Center · Checked 2026-09-22
- 11Because a single bulk job is capped at 5000 rows and only one job runs at a time, reaching tenant object caps that exceed 5000 requires several serialised bulk jobs.inferredBulk Operations in Webex Contact Center · section: Overview of Bulk Operations, read against system limits Table 1 · Checked 2026-09-22
- 12The Entry Point CSV requires Name, Service Level Threshold, Timezone and Channel Type, and optionally takes Description, Social Channel Type and Asset Name.CSV definition for bulk operations in Webex Contact Center · section: Entry Point, CSV column table · Checked 2026-09-22
- 13The Entry Point Mappings CSV requires Dialed Number, Entry Point and Region.CSV definition for bulk operations in Webex Contact Center · section: Entry Point Mappings, CSV column table · Checked 2026-09-22
- 14When a Bulk Operations job finishes with errors, the administrator can export the errors to CSV to see the per-record failure reasons and resubmit the corrected records.Bulk Operations in Webex Contact Center · section: Submit an Import Job, Export errors to CSV · Checked 2026-09-22
- 15An export job is submitted by clicking Create Bulk Operation, selecting the configuration object type, entering a filename under Export, clicking Next, and downloading the export file once the job completes.Bulk Operations in Webex Contact Center · section: Submit an Export Job · Checked 2026-09-22
- 16The documented way to bulk-update existing configuration is to run an export job, download the export file, edit the rows in that CSV, and import it again.Bulk Operations in Webex Contact Center · section: Update Configurations Using Bulk Operations · Checked 2026-09-22
- 17The CSV definition article documents a Global Variables object type for bulk operations, with required columns Name, Variable Type and Default Value and optional columns Description, Agent Editable, Agent Viewable, Reportable and Desktop Label.CSV definition for bulk operations in Webex Contact Center · section: Global Variables · Checked 2026-09-22
- 18The first row of a bulk operations CSV file is the header row and a comma separates field values.CSV definition for bulk operations in Webex Contact Center · section: intro, CSV file rules bullet list · Checked 2026-09-22
- 19The Holiday Lists CSV requires Name, Holiday Name, Start Date and End Date, with Description optional.CSV definition for bulk operations in Webex Contact Center · section: Holiday Lists, CSV column table · Checked 2026-09-22
- 20Beyond the stated rule that a skill definition must exist before it is assigned to a skill profile, Webex Contact Center publishes no global bulk import order, and any ordering must be derived from which columns are required references to other object types.inferredCSV definition for bulk operations in Webex Contact Center · whole document, keyword sweep for Ensure that and for ordering language · Checked 2026-09-22
- 21An import job is submitted by clicking Create Bulk Operation, selecting the configuration object type, browsing to and uploading the CSV file, and clicking Next.Bulk Operations in Webex Contact Center · section: Submit an Import Job · Checked 2026-09-22
- 22Bulk Operations jobs remain accessible for one year.Bulk Operations in Webex Contact Center · section: Overview of Bulk Operations · Checked 2026-09-22
- 23A Bulk Operations job reports one of five statuses: New, In Progress, Completed, Completed with errors, or Failed.Bulk Operations in Webex Contact Center · section: Submit an Import Job, job status table · Checked 2026-09-22
- 24Webex Contact Center allows 3000 address books, 6000 entries per address book and 100000 address book entries in total.System limits in Webex Contact Center · Table 1, Address Book row · Checked 2026-09-22
- 25Webex Contact Center allows 400 Outdial ANI lists, 200 entries per list and 2000 Outdial ANI entries in total.System limits in Webex Contact Center · Table 1, Outdial ANI row · Checked 2026-09-22
- 26Webex Contact Center allows 9000 skill profiles per tenant and 50 skills per skill profile.System limits in Webex Contact Center · Table 1, Skill Profiles row · Checked 2026-09-22
- 27Webex Contact Center allows 1000 active skills per tenant.System limits in Webex Contact Center · Table 1, Skills row · Checked 2026-09-22
- 28Webex Contact Center allows 20000 active users, 300 active sites and 3000 agent-based teams per tenant.System limits in Webex Contact Center · Table 1, Users / Sites / Teams rows · Checked 2026-09-22
- 29The Webex Contact Center system limits page states no limit specific to bulk operations, so the per-job row, file size and concurrency caps are documented only in the Bulk Operations pages.inferredSystem limits in Webex Contact Center · whole document, keyword sweep for bulk and CSV · Checked 2026-09-22
- 30In the bulk operations CSV definitions all column values are mandatory unless the column is explicitly marked otherwise.CSV definition for bulk operations in Webex Contact Center · section: intro, CSV file rules bullet list · Checked 2026-09-22
- 32Bulk Operations can create and edit configuration objects but cannot delete configuration objects.Bulk Operations in Webex Contact Center · section: Overview of Bulk Operations · Checked 2026-09-22
- 33Bulk Operations supports object types including Entry Point, Dial Plan, Queue, Outdial Entry Point, Outdial Queue, Site, Team, Call Recording Schedules, Call Monitoring Schedules, Users, User Profiles, Work Types, Auxiliary Code, Desktop Profiles, Desktop Layouts, Multimedia Profiles, Address Book, Threshold Rules, Outdial ANI, Skill Definition, Skill Profile, Entry Point Mappings, Audio Files, Overrides, Business Hours and Holidays.Bulk Operations in Webex Contact Center · section: Overview of Bulk Operations, supported configuration object types · Checked 2026-09-22
- 34Only one bulk operation can be active at a time in a Webex Contact Center tenant.Bulk Operations in Webex Contact Center · section: Overview of Bulk Operations · Checked 2026-09-22
- 35In the Outdial Queue CSV the Skill-Based Agent Selection column is marked not applicable.CSV definition for bulk operations in Webex Contact Center · section: Outdial Queue, CSV column table, Skill-Based Agent Selection row · Checked 2026-09-22
- 36The Overrides CSV requires Name, Timezone, Override Name, Start Datetime, End Datetime and Enabled, with Description optional.CSV definition for bulk operations in Webex Contact Center · section: Overrides, CSV column table · Checked 2026-09-22
- 37Bulk Operations in Webex Contact Center lets an administrator create, modify, import or export tenant configuration objects.Bulk Operations in Webex Contact Center · section: Overview of Bulk Operations · Checked 2026-09-22
- 38Child rows of a Queue CSV must carry the columns Name, Distribution Group Seq, Group Fallback Time and Group Teams.CSV definition for bulk operations in Webex Contact Center · section: Queue, parent-child note · Checked 2026-09-22
- 39When a queue or its call distribution groups are updated by bulk operations, the CSV must carry the entire queue definition with all distribution groups in parent-child form, and that definition overwrites the existing queue definition.CSV definition for bulk operations in Webex Contact Center · section: Queue, parent-child and update note · Checked 2026-09-22
- 40The Call Recording Schedules CSV requires Name, Queue Name, Start Date, End Date, Days of Week, Start Time, End Time, Active, Enable Pause Resume, Percentage, Filter By Sites, Filter By Teams, Filter By Agents and Stop Recording for Transferred, with Pause Duration optional.CSV definition for bulk operations in Webex Contact Center · section: Call Recording Schedules, CSV column table · Checked 2026-09-22
- 41A Bulk Operations CSV request can process a maximum of 5000 rows, and larger data sets must be split across multiple files and multiple requests.Bulk Operations in Webex Contact Center · section: Overview of Bulk Operations, CSV limits · Checked 2026-09-22
- 42Webex Contact Center rejects a bulk operations CSV file that contains more than 5000 rows.CSV definition for bulk operations in Webex Contact Center · section: intro, CSV file rules bullet list · Checked 2026-09-22
- 43The Site CSV requires Name and Multimedia Profile.CSV definition for bulk operations in Webex Contact Center · section: Site, CSV column table · Checked 2026-09-22
- 44The Skill Definition CSV requires Name, Service Level Threshold and Type, takes an optional Description, and requires List Values For Enum when Type is ENUM.CSV definition for bulk operations in Webex Contact Center · section: Skill Definition, CSV column table · Checked 2026-09-22
- 45A skill definition must already exist before that skill can be assigned to a skill profile through bulk operations.CSV definition for bulk operations in Webex Contact Center · section: Skill Profile, Skill Name column description · Checked 2026-09-22
- 46The Skill Profile CSV requires Name, Skill Name and Skill Values, and takes optional Description and Delete columns.CSV definition for bulk operations in Webex Contact Center · section: Skill Profile, CSV column table · Checked 2026-09-22
- 47In the Skill Profile CSV the profile is the parent row and each skill is a subsequent child row, and skills not mentioned in an update are left unchanged on the profile.CSV definition for bulk operations in Webex Contact Center · section: Skill Profile, parent-child note · Checked 2026-09-22
- 48The skill profile administration article directs administrators to the Submit an Export Job procedure in the Bulk Operations article to bulk download configured skill profiles.Manage skill profile in Webex Contact Center · section: Manage skill profile, bulk download note · Checked 2026-09-22
- 49The Team CSV requires Name, Site and Type, and optionally takes Multimedia Profile, Skill Profile, DN, Capacity and Desktop Layout.CSV definition for bulk operations in Webex Contact Center · section: Team, CSV column table · Checked 2026-09-22
- 50Bulk Operations offers a downloadable sample template carrying the correct CSV headers for the selected configuration object type.Bulk Operations in Webex Contact Center · section: Create Configuration Objects for Bulk Operations · Checked 2026-09-22
- 51The Threshold Rules CSV requires Name, Operand, Entity Type, Entity Name, Metric Type, Threshold Metric, Trigger Interval and Trigger Value, with Description, Notification Receivers and Text Notification Receivers optional.CSV definition for bulk operations in Webex Contact Center · section: Threshold Rules, CSV column table · Checked 2026-09-22
- 52Bulk Operations matches on the Name column: if an object name already exists the object is updated from the CSV row, and if it does not exist a new object is created.Bulk Operations in Webex Contact Center · section: Update Configurations Using Bulk Operations · Checked 2026-09-22
- 53The User CSV requires Email, User Profile and Contact Center Enabled, and optionally takes Site, Teams, Skill Profile, Desktop Profile, Multimedia Profile, External Id and Default DN.CSV definition for bulk operations in Webex Contact Center · section: User, CSV column table · Checked 2026-09-22
- 54The User Profile CSV carries a large permission matrix in which Name, Profile Type, Module Option, Agent Desktop, Reporting and Analytics, Call Monitoring, Call Recording, Logout Agents, Multimedia, Workforce Optimization, Campaign Mgr, Provisioning, Recording Management, Routing Strategy, Access Entry Points, Access Queues, Access Sites and Access Teams are required.CSV definition for bulk operations in Webex Contact Center · section: User Profile, CSV column table · Checked 2026-09-22
- 55The Working Hours CSV requires Name, Timezone, Shift Name, Days of Week, Start Time and End Time, with Description, Holiday List and Overrides optional.CSV definition for bulk operations in Webex Contact Center · section: Working Hours, CSV column table · Checked 2026-09-22
- 56The Worktype CSV requires Name and Type, and the Auxiliary Code CSV requires Name, Default and Work Type; Description is optional on both.CSV definition for bulk operations in Webex Contact Center · sections: Worktype and Auxiliary Code, CSV column tables · Checked 2026-09-22
- 57Webex Calling bulk CSV provisioning is a separate Control Hub facility from Webex Contact Center Bulk Operations and can create, update or delete elements based on field values.Bulk provisioning Webex Calling elements using CSV · section: overview · Checked 2026-09-22
- 58The Bulk Update Users, Bulk Skilling and Bulk Password Reset features announced for August 2026 belong to the Webex Contact Center Enterprise Administration Portal, not to the Webex Contact Center Bulk Operations facility in Control Hub.What's new for administrators in Webex Contact Center Enterprise · August 2026 release heading, Bulk Update Users / Bulk Skilling / Bulk Password Reset entries · Checked 2026-09-22
- 59Webex Contact Center Enterprise Bulk Update Users supports the attributes Agent Team, Profile, Agent Services, Digital Support Channel, Site, Location and Enterprise Name.What's new for administrators in Webex Contact Center Enterprise · August 2026 release heading, Bulk Update Users entry · Checked 2026-09-22
- 60The maximum supported size for an audio-file ZIP archive submitted to Bulk Operations is 50 MB.Bulk Operations in Webex Contact Center · section: Overview of Bulk Operations, audio files · Checked 2026-09-22
Documents
Bulk Operations in Webex Contact Center
Bulk Operations in Webex Contact Center (alternate article id na01x6o)
Bulk provisioning Webex Calling elements using CSV
CSV definition for bulk operations in Webex Contact Center
Enhance efficiency with pre-recorded messages
Manage skill profile in Webex Contact Center
Set up business hours for Webex Contact Center
System limits in Webex Contact Center
Webex Contact Center Documentation
What's new for administrators in Webex Contact Center Enterprise
Cite this page
APA
WarmTransfer. (2026, September 22). Webex Contact Center bulk operations imports and export jobs. WarmTransfer. https://warmtransfer.net/knowledge/webex-cc-bulk-operations
BibTeX
@misc{warmtransfer-webex-cc-bulk-operations,
title = {Webex Contact Center bulk operations imports and export jobs},
author = {{WarmTransfer}},
year = {2026},
url = {https://warmtransfer.net/knowledge/webex-cc-bulk-operations},
note = {Verified 2026-09-22}
}