Create a Group {#group-manage-add}
==================================

You can create a group and associate it with a portfolio or merchant account. Organization groups enable logical grouping of merchant accounts for more efficient account management and reporting. Each organization group can contain up to 10,000 MIDs. IMPORTANT A maximum of 5,000 groups can be set up in the system for a given organization

> IMPORTANT The owner organization specified in the request has administrative control over the group.

Endpoints
---------

**Production:** `POST ``https://api.cybersource.com``/groups`  
**Test:** `POST ``https://apitest.cybersource.com``/groups`

Required Fields for Creating a Group {#group-manage-create-req}
===============================================================

organizationId
:
The unique identifier of the organization that will own this group.

name
:
The name of the group.

Optional Fields for Creating a Group {#group-manage-create-opt}
===============================================================

description
:
The description of the group that explains the purpose of the group.

selectedOrganizationIds
:
The list of organization IDs that are members of the group.

type
:
The group type identifier used to categorize groups for organizational purposes.

REST Example: Create a Group {#group-manage-create-ex-rest}
===========================================================

Request

```
{
  "groupId": "1234574366",
  "organizationId": "groupmerchant_acct435",
  "name": "Group001",
  "description": "Group",
  "creationDateTime": "2026-04-14 15:11:02",
  "updatedDateTime": "2026-04-14 15:11:02",
  "type": "CustomGroup",
  "selectedOrganizationCount": "5",
  "selectedOrganizationIds": [
    "grptransmerchant001",
    "grptransmerchant002",
    "grptransmerchant003",
    "grptransmerchant004",
    "grptransmerchant005"
  ]
}
```

Response to a Successful Request

```
{
  "groupId": "1234574366",
  "organizationId": "groupmerchant_acct435",
  "name": "Group001",
  "description": "Group",
  "creationDateTime": "2026-04-14 15:11:02",
  "updatedDateTime": "2026-04-14 15:11:02",
  "type": "CustomGroup",
  "selectedOrganizationCount": "3",
  "selectedOrganizationIds": [
    "grptransmerchant001",
    "grptransmerchant002",
    "grptransmerchant003"
  ]
}
```