POST
/
{proxy_path_prefix}
/
rental_intents
{
  "selling_plan_id": 1234,
  "available_item_count": 3
}

To fetch a rental intent token, you will need the ID of the option that you are wanting to create a rental for, the option ID’s can be found under the configuration metafield of the product

product.metafields.supercycle.subscription_configuration

product.metafields.supercycle.membership_configuration

product.metafields.supercycle.calendar_configuration

Here is what the calendar_configuration metafield looks like, each rental period option will have a global_id.

{
  "rental_periods": [
    {
      "global_id": "gid://supercycle/CalendarRental::RentalPeriod/1",
      ...
    },
    {
      "global_id": "gid://supercycle/CalendarRental::RentalPeriod/2",
      ...
    }
  ],
  "fixed_fees": [...]
}

Path Parameters

proxy_path_prefix
string
required

The Shopify proxy path prefix configured for the app (e.g., 'customer_portal')

Body

application/json
variantId
integer
required

Shopify ID of the variant to create a rental intent for

option
object
required

Response

200
application/json
Successful response with rental intent token details
available_item_count
integer
required

Number of available items for the variant

selling_plan_id
integer

Shopify selling plan ID (present for Calendar and Subscription)

deposit_variant_id
integer

Shopify variant ID for deposit (present for Subscription)

credit_cost
integer

Credit cost for membership rentals (present for Membership)

schedule
object