---
title: "Create group"
method: POST
path: "/pws/pws_group_create/"
tags: ["Group"]
---

# Create group

`POST /pws/pws_group_create/`

The Create Group API enables the creation of group containers that apply any attributes assigned to the group to linked accounts during Card Creation or throughout the card's lifecycle. <br> Group types are beneficial for segmenting according to the options listed below, for day-to-day management of accounts and group segmentation. These types will also be visible when reviewing rules under group segmentation using Paycontrol.

## Request body

- CreateGroupModel — This web service allows to Create groups
  - `api_call_unique_identifier` string, required — Unique number that must be passed at each API request. Identifier to make each API request unique
  - `client_id` integer, required — Unique identifier for the client which Paymentology will provide at outset
  - `group_desc` string, required — group Description
  - `group_name` string, required — group Name
  - `group_type` integer, required — Indicates the type of group. They are listed below:<ul> <li class="docBullet" >group_type =2 indicates General Container</li> <li class="docBullet" >group_type =3 indicates Fees group</li> <li class="docBullet" >group_type =4 indicates Auth activities</li> <li class="docBullet" >group_type =5 indicates Settlement Activities</li> <li class="docBullet" >group_type =6 indicates Scheduled Tasks</li> <li class="docBullet" >group_type =7 indicates Fraud Assessment</li> <li class="docBullet" >group_type =8 indicates AI rules</li> <li class="docBullet" >group_type =9 indicates wallet Interactions</li> </ul>
  - `risk_level` string, required — Risk Level .Supported Value for risk level are : <ul> <li class="docBullet" >Default</li> <li class="docBullet" >Low</li> <li class="docBullet" >Very Low</li> <li class="docBullet" >High</li> <li class="docBullet" >Very High</li> <li class="docBullet" >Custom</li> </ul>
  - `user_id` string — User Id of the Customer who triggered the API request.
  - `remarks` string — Remarks for API request

## Response `200`

Successful Response

- CreateGroupResponseModel
  - `header` ResponseHeader
    - `error_id` integer — Error Id
    - `error_desc` string — Error Message
  - `body` CreateGroupResponseModelBody
    - `id` integer — Newly Created group Id

## Other responses

- `404` — Webservices does not exist
- `500` — Internal Server error

---

[API](https://skmtc.net/paymentology/apis/payapi-docs.md) · [All operations](https://skmtc.net/paymentology/apis/payapi-docs/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/paymentology/payapi-docs/revisions/a675891b0365/schema)