Subscription

Get current subscription

Returns your current subscription status. If no subscription exists, returns a free plan default.

Required scope: read_subscription

Request

curl https://app.simpleproductfeeds.com/v1/subscription \
  -H "Authorization: Bearer spf_live_sk_your_key_here"

Response (active subscription)

{
  "data": {
    "object": "subscription",
    "plan": "growth",
    "plan_name": "Growth",
    "status": "active",
    "created_at": "2026-01-15T10:00:00Z"
  }
}

Response (no subscription)

{
  "data": {
    "object": "subscription",
    "plan": "free",
    "status": "none"
  }
}

Response fields

---

Create a subscription

Creates a new Shopify subscription for a paid plan. Returns a confirmation URL that the merchant must visit in the Shopify Admin to approve the charge.

Required scope: write_subscription

Parameters

Parameter	Type	Required	Description
plan	string	Yes	Plan code name (e.g., starter, growth, premium). Alternatively use code_name.
discount_code	string	No	Optional discount code to apply.

Request

curl -X POST https://app.simpleproductfeeds.com/v1/subscription \
  -H "Authorization: Bearer spf_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"plan": "growth"}'

Response

{
  "data": {
    "object": "subscription",
    "confirmation_url": "https://admin.shopify.com/store/my-store/charges/confirm?...",
    "message": "Redirect the merchant to the confirmation URL to approve the subscription."
  }
}

The confirmation_url must be opened in the Shopify Admin by the store owner to approve the charge. The subscription is not active until approved.

Errors

Status	Code	Description
422	missing_param	The plan parameter is required.
422	subscription_failed	Failed to create the subscription. See error message for details.

---

Cancel subscription

Cancels the active subscription. The shop reverts to the free plan.

Required scope: write_subscription

Request

curl -X DELETE https://app.simpleproductfeeds.com/v1/subscription \
  -H "Authorization: Bearer spf_live_sk_your_key_here"

Response

{
  "data": {
    "object": "subscription",
    "status": "cancelled",
    "message": "Subscription cancelled. Your shop is now on the free plan."
  }
}

Errors

Status	Code	Description
500	cancel_failed	Failed to cancel the subscription.