Add a component of the subscription line’s existing plan
Flat per-unit licensed seats and plain per-unit metered components support renewal notices. Tiered, package, decimal and special-term components still return notice_unsupported_shape. Validates an active seat or metered price in the same plan and slot, on the subscription processor account. Currency and interval must match. The resulting composition requires the base and permits at most two seat components. Metered components omit quantity. Uses product proration settings without changing the billing date. Requires a merchant person or key; agent approvals and customer sessions are not supported.
/subscriptions/{subscription}/itemsFlat per-unit licensed seats and plain per-unit metered components support renewal notices. Tiered, package, decimal and special-term components still return notice_unsupported_shape. Validates an active seat or metered price in the same plan and slot, on the subscription processor account. Currency and interval must match. The resulting composition requires the base and permits at most two seat components. Metered components omit quantity. Uses product proration settings without changing the billing date. Requires a merchant person or key; agent approvals and customer sessions are not supported.
Authorization
bearerAuth In: header
Path Parameters
Opaque subscription ID.
^sbs_[0-7][0-9abcdefghjkmnpqrstvwxyz]{25}$(?![\s\S])Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/subscriptions/string/items" \ -H "Content-Type: application/json" \ -d '{ "price": "string" }'{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "status": "string", "approval": { "id": "string", "expires_at": "2019-08-24T14:15:22Z" }}Activate Product POST
Activates a draft product locally after it has an active plan. Live mode requires catalog:publish. Repeated activation returns 409 catalog_status_invalid. Cookie members require Hms-Company and Hms-Livemode; Idempotency-Key returns 400 invalid_request with idempotency_not_supported_for_member_routes. Bearer callers require Idempotency-Key.
Approve Affiliate Request POST
Approves a pending request once. A join or more-programs approval makes the membership approved, activates a pending affiliate that has signed in, and links the affiliate's own customer record when exactly one active customer has their email. Refused (409) while the affiliate has a live ban or when the request was already decided. Cookie members require Hms-Company and Hms-Livemode; Idempotency-Key returns 400 invalid_request with idempotency_not_supported_for_member_routes. Bearer callers require Idempotency-Key. Agents cannot write affiliate records.