---
title: "Link an Account to a Group"
method: POST
path: "/pws/pws_link_account_group/"
tags: ["Group"]
---

# Link an Account to a Group

`POST /pws/pws_link_account_group/`

You can utilize this API to link an existing account to a group. By linking an account, it will inherit all the attributes managed by the group, such as fraud rules or fee rule calculations. At any time, you have the flexibility to unassign an account from a group using the Unlink Account Group API.

## Request body

- PwsLinkAccountGroupModel — Link account(s) to a Credit group, based on specific customer characteristics.
  - `acc_id` integer, required — account id
  - `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_id` string, required — comma separated group Id's.
  - `user_id` string — User Id of the Customer who triggered the API request.
  - `remarks` string — Remarks for API request

## Response `200`

Successful Response

- LinkAccountGroupResponse
  - `header` LinkAccountGroupHeader
    - `error_id` integer — error id
    - `error_desc` string — error message
  - `body` LinkAccountGroupBody
    - `message` string — message

## 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)