subscriptions/downgrade

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Triggered when a customer downgrades their subscription to a lower-tier plan, containing information about the new subscription configuration.

Sample payload

{
 "id": "f9d21e4c-7a6b-5832-900a-25f91d8b37c5",
 "plan": {
   "id": "8cef41a5-2300-4b15-a8f8-8bb055841a27",
   "name": "Premium Pro",
   "amount": 99.99,
   "public": true,
   "features": {
     "views": {
       "id": "c4a23df7-eab1-4ad9-b13e-057285dd67e1",
       "name": "Views",
       "type": "limit_with_overage",
       "value": "250",
       "description": "",
       "displayOrder": 4
     },
     "custom_notifications": {
       "id": "35cc2416-6142-4d47-a81d-c9d1548ae518",
       "name": "Custom notifications",
       "type": "boolean",
       "value": false,
       "description": "",
       "displayOrder": 0
     }
   },
   "interval": "EVERY_30_DAYS",
   "createdAt": "2025-03-17T17:24:20.314Z",
   "trialDays": 0,
   "updatedAt": "2025-03-18T12:02:53.156Z",
   "description": null,
   "currencyCode": "USD",
   "customFields": {
     "Test": "",
     "Recommended": "false"
   },
   "usageCharges": [],
   "featuresOrder": [
     "custom_notifications",
     "views"
   ]
 },
 "topic": "subscriptions/cancel",
 "active": false,
 "shopify": {
   "id": "gid://shopify/AppSubscription/46066106686"
 },
 "cancelOn": null,
 "customer": {
   "id": "064df714-c9c8-48f8-a91b-e0818755f570",
   "name": "mountainview",
   "tags": [
     "seasonal",
     "newcustomer"
   ],
   "test": true,
   "email": "[email protected]",
   "shopify": {
     "id": "91733426494",
     "isPlus": false,
     "shopId": "91733426494",
     "planName": "Developer Preview",
     "isDevPlan": true,
     "myshopifyDomain": "mountainview.myshopify.com"
   },
   "platformId": "91733426494",
   "installedAt": "2025-01-27T17:17:18.000Z",
   "billingStatus": "canceled",
   "lifetimeValue": 0,
   "trialStartsAt": "2025-02-10T00:00:00.000Z",
   "uninstalledAt": null,
   "trialExpiresAt": "2025-02-17T00:00:00.000Z",
   "averageMonthlyRevenue": 0
 },
 "features": {
   "views": {
     "id": "c4a23df7-eab1-4ad9-b13e-057285dd67e1",
     "name": "Views",
     "type": "limit_with_overage",
     "value": "250",
     "description": "",
     "displayOrder": 4
   },
   "custom_notifications": {
     "id": "35cc2416-6142-4d47-a81d-c9d1548ae518",
     "name": "Custom notifications",
     "type": "boolean",
     "value": false,
     "description": "",
     "displayOrder": 0
   }
 },
 "frozenAt": null,
 "createdAt": "2025-03-18T13:44:21.041Z",
 "canceledAt": "2025-03-18T13:50:10.303Z",
 "activatedAt": "2025-03-18T13:44:36.044Z",
 "usageCharges": [],
 "featuresOrder": [
   "custom_notifications",
   "views"
 ],
 "confirmationUrl": "https://mountainview.myshopify.com/admin/charges/145072685057/46066106686/RecurringApplicationCharge/confirm_recurring_application_charge?signature=BAh7BzoHaWRsKwg%2BAcG5CgA6EmF1dG9fYWN0aXZhdGVU--1c0d3af26284719d5fae2caa68cb37f69b6760fb",
 "currentPeriodEnd": "2025-04-18T13:44:36.044Z",
 "usageBalanceUsed": 99.99,
 "usageCappedAmount": 1000,
 "currentPeriodStart": "2025-03-18T13:44:36.044Z",
 "shopifySubscription": {
   "id": "gid://shopify/AppSubscription/46066106686"
 }
}
{
  "id": "sub_F9d21e4c7a6b5832",
  "plan": {
    "id": "price_8cef41a52300b15a",
    "name": "Premium Pro",
    "amount": 99.99,
    "public": true,
    "features": {
      "views": {
        "id": "feat_views_c4a23df7eab1",
        "name": "Views",
        "type": "limit_with_overage",
        "value": "250",
        "description": "",
        "displayOrder": 4
      },
      "custom_notifications": {
        "id": "feat_cn_35cc24166142",
        "name": "Custom notifications",
        "type": "boolean",
        "value": false,
        "description": "",
        "displayOrder": 0
      }
    },
    "interval": "month",
    "createdAt": "2025-03-17T17:24:20.314Z",
    "trialDays": 0,
    "updatedAt": "2025-03-18T12:02:53.156Z",
    "description": null,
    "currencyCode": "USD",
    "customFields": {
      "Test": "",
      "Recommended": "false"
    },
    "usageCharges": [],
    "featuresOrder": [
      "custom_notifications",
      "views"
    ],
    "stripe": {
      "id": "price_8cef41a52300b15a",
      "createdAt": "2025-03-17T17:24:20.314Z"
    }
  },
  "topic": "subscriptions/downgrade",
  "active": false,
  "cancelOn": null,
  "customer": {
    "id": "cus_064df714c9c848f8",
    "name": "mountainview",
    "tags": [
      "seasonal",
      "newcustomer"
    ],
    "test": true,
    "email": "[email protected]",
    "platformId": "91733426494",
    "installedAt": "2025-01-27T17:17:18.000Z",
    "billingStatus": "canceled",
    "lifetimeValue": 0,
    "trialStartsAt": "2025-02-10T00:00:00.000Z",
    "uninstalledAt": null,
    "trialExpiresAt": "2025-02-17T00:00:00.000Z",
    "averageMonthlyRevenue": 0
  },
  "features": {
    "views": {
      "id": "feat_views_c4a23df7eab1",
      "name": "Views",
      "type": "limit_with_overage",
      "value": "250",
      "description": "",
      "displayOrder": 4
    },
    "custom_notifications": {
      "id": "feat_cn_35cc24166142",
      "name": "Custom notifications",
      "type": "boolean",
      "value": false,
      "description": "",
      "displayOrder": 0
    }
  },
  "frozenAt": null,
  "createdAt": "2025-03-18T13:44:21.041Z",
  "canceledAt": "2025-03-18T13:50:10.303Z",
  "activatedAt": "2025-03-18T13:44:36.044Z",
  "usageCharges": [],
  "featuresOrder": [
    "custom_notifications",
    "views"
  ],
  "confirmationUrl": null,
  "currentPeriodEnd": "2025-04-18T13:44:36.044Z",
  "usageBalanceUsed": 99.99,
  "usageCappedAmount": 1000,
  "currentPeriodStart": "2025-03-18T13:44:36.044Z",
  "stripe": {
    "id": "sub_F9d21e4c7a6b5832",
    "createdAt": "2025-03-18T13:44:21.041Z"
  }
}
Body Params

A subscription was downgraded

string

The topic of the webhook

subscription
object
Response
200

Return a 200 status to indicate that the data was received successfully

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here!