Fixed
Webhook application ID, rate limits and response fields corrected
October 26th, 2026
We tested the API reference against live calls and fixed what didn't match:
- Webhooks: in
/core/v3/applications/{application_id}/..., use your app's client ID (the 32-character Application ID you got at registration) asapplication_id. The numeric app ID returns403 Forbidden. - Rate limits: Guidelines and Conventions now lists the real limits per endpoint group, counted per app per store, and the
RateLimit-*headers on every response. Over the limit, you get429with aRetry-Afterheader. - Retrieve Loyalty Customer Details: wrap the body in a
customersobject. A customer that isn't in the loyalty program returns404. - New response fields:
external_variant_idon order line items.- Image sizes on All Products.
is_incentivized,incentive_typeanduser_typeon reviews.- A full response schema for Product Data.
- Errors: app-level webhook endpoints no longer list a
sourcefield, which they don't return. Promoted Products documents the401returned when the store doesn't have the feature, and Retrieve Existing Comment the404for a review without a comment.
Endpoints affected: all webhook target, filter and subscription endpoints, Retrieve Orders, Retrieve order by ID, All Products, Product Data, All Reviews, Review by ID, Promoted Products, Retrieve Existing Comment, Retrieve Loyalty Customer Details, Guidelines and Conventions, Errors.
