Create (or enable) a pricing group
Enables a group titled title on your business and returns
{id, title}. The catalog is global and capped at 64 ids, so
if a group with the same title already exists (case-insensitive)
it is reused rather than duplicated. A full catalog surfaces as
400 with “price group catalog is full” — pick an existing title
from ?all=true instead.
Authorizations
Authorization: Basic base64(partner_key:secret_key).
Credentials are issued by a klikit operator. The plaintext
secret_key is shown once at issuance and cannot be retrieved
later — store it securely. If lost, ask your operator to rotate
the secret to receive a new one. The old secret stops working
immediately on rotation; there is no overlap window.
Body
Tier label, e.g. "Mall". Reused case-insensitively on create.
1Response
The created / reused group — data is {id, title}.
Canonical response wrapper. Every response — success or error —
carries the request_id so you can quote one id to klikit
support to correlate a request end-to-end.
"req_4d1b7e3f-..."
Endpoint-specific payload on success.
Machine-readable error code + human message. The code is stable
across releases — switch on code in your client code rather
than parsing the message text.
Common codes you will encounter as a partner: