Skip to main content

AddSubscriptionItem adds a new item to the subscription.

POST 
/api/v1/billing/subscription/items

Adds a billable item like additional seats, phone numbers, or add-on features. Pricing is determined by the lookup_key mapping to configured prices.

Authorization​

Requires billing:manage permission.

Lookup Keys​

Common lookup keys:

  • "seat.voice": Voice-only agent seat
  • "seat.digital": Digital channels agent seat
  • "seat.omnichannel": Full omnichannel agent seat
  • "phone_number": DID phone number
  • "trunk": SIP trunk

Response​

Returns created SubscriptionItem with pricing details.

Errors​

  • NOT_FOUND: No subscription exists
  • INVALID_ARGUMENT: Unknown lookup_key or invalid quantity
  • FAILED_PRECONDITION: Would exceed plan capacity
  • PERMISSION_DENIED: Caller lacks billing:manage permission

Request​

Responses​

A successful response.