Create KYC Group

Creates a new KYC group in the system.

Request

POST /v2/admin/kyc/groups

Parameters

Name	Type	In	Description
name	string	body	Required. The name of the KYC group

Headers

Name	Description
Authorization	Required. Bearer token for authentication
Content-Type	Required. Must be application/json

Request Body

{
  "name": "Premium Investors"
}

Example

curl --request POST \
  --url '{{baseUrl}}/v2/admin/kyc/groups' \
  --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "Premium Investors"
  }'

Response

A successful request returns an HTTP 201 status code with the action response.

{
  "requires_approval": false,
  "completed": true
}

Response Fields

Field	Type	Description
requires_approval	boolean	Whether the action requires approval
completed	boolean	Whether the action was completed immediately

Status Codes

Status Code	Description
201	Success - KYC group created
400	Bad Request - Invalid parameters
401	Unauthorized - Invalid or missing authentication token
409	Conflict - KYC group with the same name already exists
500	Internal Server Error