Create a brand
Adds a new brand under your business. business_id is taken
from the credential and any value supplied in the body is
overwritten. branch_ids is the list of branch ids the brand
should be available in (must already belong to the same
business).
Forwarded as-is to core’s brand-create handler — the upstream
validates title, requires logo + banner, and surfaces
per-field errors at error.details.
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
Mirrors core's BrandCreateUpdateReq. business_id is rewritten
from the partner credential, so any value sent in the body is
ignored. On update, set branch_list_changed: true whenever
branch_ids differs from the current set so the upstream
re-runs the many-to-many wiring.
1 - 255250250Response
Brand created. Payload mirrors core's brand model — data.id is the new brand id.
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: