---
title: "Create a partner update subscription token"
method: POST
path: "/partner/billing/update-subscription/token"
tags: ["Partner Billing"]
---

# Create a partner update subscription token

`POST /partner/billing/update-subscription/token`

Creates a partner subscription token with the intention of updating a subscription (called by partner using retailer's access token)

🔒 Requires: `billing:partner_subscription:write` scope

## Request body

- PartnerUpdateSubscriptionTokenRequest — PartnerUpdateSubscriptionTokenRequest represents the request's body for updating a subscription via token API
  - `components` PartnerUpdateSubscriptionTokenComponent[] — Components is a list of components to add on to the plan
    - `component_handle` string, required — Unique reference for the component to be updated
    - `component_price_handle` string — Unique reference for the component price point to be updated to
    - `quantity` integer, required — How many components should be there after the update
  - `price_handle` string — ProductPricePointHandle is the product price point handle, required if `product_handle` is specified
  - `product_handle` string — ProductHandle is the product handle to update
  - `return_url` string, required — ReturnURL is the URL to which the user is redirected to after giving his/her consent

## Response `200`

- object
  - `data` PartnerSubscriptionTokenResponse — PartnerSubscriptionTokenResponse contains the token and its expiration time
    - `expires_at` string — ExpiresAt is the exact time of token expiry in UTC timezone and displayed in RFC3339 format
    - `expires_in` string — ExpiresIn is the number of seconds till the token is expired
    - `token` string — Token is a randomly generated string that is a required parameter for consent page

---

[API](https://skmtc.net/lightspeedhq/apis/api-2026-07.md) · [All operations](https://skmtc.net/lightspeedhq/apis/api-2026-07/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lightspeedhq/api-2026-07/revisions/72d4ceb46dbb/schema)