Granting Bonuses

Web App
API + SDK

To grant bonues to customers via the Web App…

Go to customer details page

Go to the customers page and find and click on a customer.

Click grant bonus

Scroll down to the bonuses section and click the Grant Bonus button

Bonuses section in customer details page in PriceOS

Set options

Select a feature, input an amount, and optionally set a reason and expiration date

Save

Click the Grant Bonus button

You can use the create bonus endpoint to grant bonuses to a customer.

const result = await priceos.bonuses.create({
  customerId: "customer_123",
  featureKey: "api_calls",
  amount: 100,
  expiresAt: Date.parse("2026-12-31T23:59:59.000Z"),
  reason: "promotion",
  metadata: {
    campaign: "winter_promo",
  },
});

curl -X POST "https://api.priceos.com/v1/bonuses" \
  -H "x-api-key: PRICEOS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "customerId": "customer_123",
    "featureKey": "api_calls",
    "amount": 100,
    "expiresAt": 1798761599000,
    "reason": "promotion",
    "metadata": {
      "campaign": "winter_promo"
    }
  }'

Getting Started

Features

Products

Customers

Usage

Bonuses

Overrides

Account

Granting Bonuses