v1

latestOpenAPI 3.1.0Copyright Pismo2026-07-247702,7523.1 MB

Attribute groups

Create attribute group

Create an attribute group, which is a set of values that can be shared across multiple flex controls within the organization. Once you create an attribute group, you reference it in flex controls in the conditions field in the Create account flex control or Create customer flex control endpoint.

For more information, refer to the Attribute groups guide.

post/v1/attribute-groups

Request body

idstring required

Attribute group ID, unique within the organization

descriptionstring required

Short description of the attribute group

type'merchant_id' | 'merchant_category_code' required

Flex control scope

merchant_category_code: Merchant category code (MCC) is a four-digit number assigned to a business by credit card companies. It is used to classify the business by the type of goods or services it provides.
merchant_id: Unique ID assigned to a merchant by the payment processor.

valuesstring[] required

Attribute group values

Each value must be unique within the array
Maximum of 20,000 items
Each item must not exceed 15 characters

Example request

{
  "id": "non-trusted-merchants",
  "description": "High-risk merchant IDs",
  "values": [
    "0123",
    "2224",
    "3876"
  ]
}

Response

OK. Successful attribute group creation.