---
title: "Create a payment instrument group"
method: POST
path: "/paymentInstrumentGroups"
tags: ["Payment instrument groups"]
---

# Create a payment instrument group

`POST /paymentInstrumentGroups`

Creates a payment instrument group to associate and group payment instrument resources together. You can apply a transaction rule to a payment instrument group.

## Request body

- PaymentInstrumentGroupInfo
  - `balancePlatform` string, required — The unique identifier of the [balance platform](https://docs.adyen.com/api-explorer/#/balanceplatform/latest/get/balancePlatforms/{id}__queryParam_id) to which the payment instrument group belongs.
  - `description` string — Your description for the payment instrument group.
  - `properties` object — Properties of the payment instrument group.
  - `reference` string — Your reference for the payment instrument group.
  - `txVariant` string, required — The tx variant of the payment instrument group.

## Response `200`

OK - the request has succeeded.

- PaymentInstrumentGroup
  - `balancePlatform` string, required — The unique identifier of the [balance platform](https://docs.adyen.com/api-explorer/#/balanceplatform/latest/get/balancePlatforms/{id}__queryParam_id) to which the payment instrument group belongs.
  - `description` string — Your description for the payment instrument group.
  - `id` string — The unique identifier of the payment instrument group.
  - `properties` object — Properties of the payment instrument group.
  - `reference` string — Your reference for the payment instrument group.
  - `txVariant` string, required — The tx variant of the payment instrument group.

## Other responses

- `400` — Bad Request - a problem reading or understanding the request.
- `401` — Unauthorized - authentication required.
- `403` — Forbidden - insufficient permissions to process the request.
- `422` — Unprocessable Entity - a request validation error.
- `500` — Internal Server Error - the server could not process the request.

---

[API](https://skmtc.net/adyen/apis/balanceplatformservice.md) · [All operations](https://skmtc.net/adyen/apis/balanceplatformservice/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/adyen/balanceplatformservice/revisions/8761ac1a9aab/schema)