---
title: "AuthorisationGroup:Create"
method: POST
path: "/v2/authorisationgroups"
tags: ["AuthorisationGroup"]
---

# AuthorisationGroup:Create

`POST /v2/authorisationgroups`

Create your custom authorisation group

## Request body

- object

## Response `201`

AuthorisationGroup resource created

- AuthorisationGroupAuthorisationGroupOutput
  - `code` string — The code of the authorisation group.
  - `name` string — Name of the authorisation group.
  - `description` string — Description of the authorisation group.
  - `type` 'package' | 'right' | 'module' — Type of authorisation group. Valid values are right, module, and package. Defaults to right when omitted.
  - `requiredAuthorisationGroup` string, nullable — AG-code of the authorisation group that is required before this authorisation group can be enabled.
  - `linkedProfileCode` string, nullable — CP-code of the linked company profile.
  - `purpose` AuthorisationGroupAuthorisationGroupPurposeOutput
    - `account` boolean — Indicates whether this authorisation group can be assigned to an account.
    - `merchant` boolean — Indicates whether this authorisation group can be assigned to a merchant.
    - `token` boolean — Indicates whether this authorisation group can be assigned to an authentication token.
    - `relation` boolean — Indicates whether this authorisation group can be assigned to a merchant connection.
  - `public` boolean — Indicate if the authorisation group is public.
  - `translations` object — Object containing translations for the authorisation group fields.
  - `authorisationObjects` AuthorisationGroupAuthorisationObjectOutput[] — Array of authorisation objects linked through the authorisation group.
    - `code` string — The unique identifier of the authorisation object.
    - `name` string — Name of the authorisation object.
    - `translations` object — Object containing translations for the authorisation object fields.
  - `createdAt` string, date-time, nullable — The date and time at which this entity was created in ISO-8601 (ATOM) notation
  - `createdBy` string, nullable — The reference to an account or token whom created the entity
  - `modifiedAt` string, date-time, nullable — The date and time at which this entity was modified in ISO-8601 (ATOM) notation.
  - `modifiedBy` string, nullable — The reference to an account or token whom modified this entity
  - `deletedAt` string, date-time, nullable — The date and time at which this entity was deleted in ISO-8601 (ATOM) notation.
  - `deletedBy` string, nullable — The reference to an account or token whom deleted the entity
  - `_links` LinkOutput[], nullable
    - `href` string, nullable — The URI to the linked resource
    - `rel` string, nullable — The name of the linked resource
    - `type` string, nullable — The (http(s)) method needed to approach the linked resource

## Other responses

- `400` — Invalid input
- `422` — Unprocessable entity

---

[API](https://skmtc.net/pay/apis/pay-transaction-gateway-unit-api.md) · [All operations](https://skmtc.net/pay/apis/pay-transaction-gateway-unit-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pay/pay-transaction-gateway-unit-api/versions/2bc260c7bdfc/schema)