POST/api/v2/loyalty/rules

Create a new loyalty rule for the authenticated company's loyalty program

Authentication

Send your API key in the x-api-key header on every request.

Request body

application/json

Request body fields
FieldTypeRequiredDescription
RuleNamestringYes
RuleTypestringYes
PointsPerUnitunknownYes
MinTransactionAmountunknownNo
MaxTransactionAmountunknownNo
MerchantCategorystringNo
UserTierstringNo
PriorityunknownNo
IsActivebooleanNo
ValidFromstring (date-time)No
ValidUntilstring (date-time)No
MultiplierunknownNo

Responses

201 — Created

Response 201 fields
FieldTypeRequiredDescription
IdunknownNo
RuleNamestringNo
RuleTypestringNo
PointsPerUnitunknownNo
MinTransactionAmountunknownNo
MaxTransactionAmountunknownNo
MerchantCategorystringNo
UserTierstringNo
PriorityunknownNo
IsActivebooleanNo
ValidFromstring (date-time)No
ValidUntilstring (date-time)No
MultiplierunknownNo
CreatedAtstring (date-time)No
UpdatedAtstring (date-time)No

400 — Bad Request

Response 400 fields
FieldTypeRequiredDescription
MessagestringNo
CodestringNo
StatusunknownNo
ValidationErrorsobjectNo
DetailsstringNo

401 — Unauthorized

Response 401 fields
FieldTypeRequiredDescription
MessagestringNo
CodestringNo
StatusunknownNo
ValidationErrorsobjectNo
DetailsstringNo

500 — Internal Server Error

Response 500 fields
FieldTypeRequiredDescription
MessagestringNo
CodestringNo
StatusunknownNo
ValidationErrorsobjectNo
DetailsstringNo

Example request

curl -X POST "https://{base_url}/api/v2/loyalty/rules" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"RuleName":"…","RuleType":"…","PointsPerUnit":"…"}'

This page is generated from the live OpenAPI specification and always matches the current API.