Skip to main content
Configures pricing for a plan or addon, supporting various billing models.

​
Mutation

mutation SetPackagePricing($input: PackagePricingInput!) {
  setPackagePricing(input: $input) {
    packageId
    prices {
      billingModel
      billingPeriod
      billingCadence
      price {
        amount
        currency
      }
      tiers {
        upTo
        unitPrice {
          amount
          currency
        }
      }
    }
  }
}

​
Parameters

​
input
PackagePricingInput
required
Input for setting package pricing

​
Billing Models

ModelDescription
FLAT_FEEFixed recurring price
USAGE_BASEDBased on metered usage
TIEREDVolume-based tiers
CREDIT_BASEDDeduct from credit balance

​
Examples

​
Flat Fee Pricing

{
  "input": {
    "packageId": "plan-uuid-123",
    "pricingType": "PAID",
    "prices": [
      {
        "billingModel": "FLAT_FEE",
        "billingPeriod": "MONTHLY",
        "price": { "amount": 99, "currency": "USD" }
      }
    ]
  }
}

​
Usage-Based Pricing

{
  "input": {
    "packageId": "plan-uuid-123",
    "pricingType": "PAID",
    "prices": [
      {
        "billingModel": "USAGE_BASED",
        "billingPeriod": "MONTHLY",
        "featureId": "feature-api-calls",
        "price": { "amount": 0.01, "currency": "USD" }
      }
    ]
  }
}

​
Tiered Pricing

{
  "input": {
    "packageId": "plan-uuid-123",
    "pricingType": "PAID",
    "prices": [
      {
        "billingModel": "TIERED",
        "billingPeriod": "MONTHLY",
        "featureId": "feature-api-calls",
        "tiers": [
          { "upTo": 1000, "unitPrice": { "amount": 0, "currency": "USD" } },
          { "upTo": 10000, "unitPrice": { "amount": 0.01, "currency": "USD" } },
          { "upTo": null, "unitPrice": { "amount": 0.005, "currency": "USD" } }
        ]
      }
    ]
  }
}