On This Page

Create a Group

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

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

Optional Fields for Creating a Group

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

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"
  ]
}