Subscription contract webhooks not firing

Technical Q&A
1

Hi everyone,

I’m having trouble receiving webhook events for subscription_contracts/create despite having everything configured correctly. I’d appreciate any insights into what might be causing this issue.

Setup:

  • Using Shopify Subscriptions app (installed and working)

  • Custom app configured via Shopify CLI

  • Testing on a development store

  • Webhook configured in shopify.app.toml

  • shopify app deploy completes successfully without errors

  • Configuration verified in Partner Dashboard

shopify.app.toml configuration:

[webhooks]
api_version = "2025-10"

[[webhooks.subscriptions]]
topics = [
  "subscription_contracts/create",
  "subscription_contracts/update",
  "subscription_contracts/fail",
  "subscription_contracts/cancel",
  "subscription_contracts/pause"
]
uri = "<published https endpoint>"

[access_scopes]
scopes = "write_products, read_own_subscription_contracts, read_customer_payment_methods, write_own_subscription_contracts"

What I’ve tried:

  1. Verified subscription contracts are being created successfully through the online store checkout

  2. Confirmed the Lambda endpoint is accessible and returns 200 status

  3. Added all recommended scopes including read_customer_payment_methods and write_own_subscription_contracts

  4. Checked CloudWatch logs - no webhook requests are reaching the endpoint

  5. Verified that mandatory webhooks like app/uninstalled work fine with lowercase format

Questions:

  1. Do subscription contract webhooks created by the Shopify Subscriptions app trigger webhooks for other apps, or are they only accessible to the app that created them?

  2. Is there a specific permission or approval process required even for development stores?

  3. Should the topic format be subscription_contracts/create (REST style) or SUBSCRIPTION_CONTRACTS_CREATE (GraphQL style) in shopify.app.toml?

  4. Are there any additional configuration steps needed for subscription webhooks beyond what’s documented?

Any help would be greatly appreciated!

Environment:

  • Development store

  • Shopify CLI (latest version)

  • API version: 2025-10

2

Could you explain the issue you are facing on your site