---
schema_version: "1"
id: 9576cfc300ebc76dbe78396a011fffe068c552487b4a7d25189112844d4f06b2
title: Create Contact Center Groups in Bulk
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/service/264-0-0/voice_bulk_add_groups.md
canonical_url: https://help.salesforce.com/s/articleView?id=service.voice_bulk_add_groups.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: c0fff8310f56147870691a061557bb667c319b41c1a9ac73829f000f7f968ce3
description: Use the Salesforce Bulk API 2.0 to create contact center groups in bulk. The bulk operation helps to efficiently manage large contact centers.
products:
  - Service Cloud
  - Digital Engagement
release: "264"
---
# Create Contact Center Groups in Bulk

Use the Salesforce Bulk API 2.0 to create contact center groups in bulk. The bulk operation helps to efficiently manage large contact centers.

### Required Editions

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small edition"><colgroup><col></colgroup><tbody><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;"><a href="https://help.salesforce.com/s/articleView?id=service.voice_editions.htm&amp;release=264.0.0&amp;type=5" title="Learn about the user interfaces, editions, and add-ons that support Voice solutions by Salesforce.">View supported editions</a>.</td></tr></tbody></table>

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small permission">
        <colgroup>
          <col style="width:50%">
          <col style="width:50%">
        </colgroup>
        <thead class="slds-text-title_caps ">
          <tr class="">
            <th scope="colgroup" class="slds-cell-wrap" colspan="2" style="text-align:center;vertical-align:top;" id="d84019e60">User Permissions Needed</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d84019e60 ">To create and manage a contact center:</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d84019e60 ">Salesforce Voice Contact Center Admin</td>

          </tr>
        </tbody>
      </table>

Applies to these telephony models

- Salesforce Voice with Amazon Connect.
- Salesforce Voice with Partner Telephony from Amazon Connect. Also applies to Voice manually integrated with your Amazon Connect instance by importing the contact center definition XML file with the connect management role.

Before you begin, make sure that the Update Amazon Connect Queues and Routing Profiles option is enabled in your Contact Center settings.

1. Create a CSV file with the required fields, and add the group records.
    
    Argument1: Add the group name.
    
    Argument2: Add the group API name.
    
    Argument3: Add the group description.
    
    Argument4: (Optional) Add the routing profile ARN from your AWS account.
    
    Argument5: Add the contact center ID.
    
    Argument6: Add the default outbound queue ID.
    
    BulkAction: The value for this field must be `AddGroups`.
    
    An example CSV is available in [GitHub](https://github.com/service-cloud-voice/examples-from-doc/tree/main/BulkOperations/bulk_add_groups.csv).
2. Follow the instructions in the [Bulk API 2.0 Developer Guide](https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/bulk_api_2_0.htm) to use the bulk API to create a job, upload job data, and complete the upload. Use your preferred method to trigger the `ContactCenterBulkOp` entity and upload the CSV file.
    
    You can add or update only the Argument1, Argument2, Argument3, Argument4, Argument5, Argument6, and BulkAction fields. The remaining fields are read-only.
3. Query the `Status` field to check the status of the bulk action.
4. Refresh the org and AWS account to confirm that the groups are added to the contact center.
5. After adding the groups, create another CSV file to associate queues with the groups.
    
    Argument1: Add the group ID.
    
    Argument2: Add the queue ID.
    
    Argument5: Add the contact center ID.
    
    BulkAction: The value for this field must be AssociateQueuesToGroups.
    
    An example CSV is available in [GitHub](https://github.com/service-cloud-voice/examples-from-doc/tree/main/BulkOperations/bulk_associate_queues_to_group.csv).
6. Follow the instructions in the [Bulk API 2.0 Developer Guide](https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/bulk_api_2_0.htm) to use the bulk API to create a job, upload the associated CSV data, and complete the upload.

If an error occurs in the CSV file for one or more records, the bulk operation only fails for those records. You can query the `ErrorMessage` field of the `ContactCenterBulkOp` entity to view the specific error message.

The limit for adding groups using the Bulk API is 5000 per API request.

#### See Also

- [_Salesforce Developer Guide_: Bulk API 2.0](https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/bulk_api_2_0.htm)