Developers

Webhook subscriptions

Markdown

Update a subscription

Pause or resume, or remove topics.

PATCH/stores/{storeId}/v1/webhook-subscriptions/{id}
No scope required

Path parameters

idstring (uuid)required

Request body

stateobject
active paused
event_typesarray<string>

Response

dataobjectrequired
idstring (uuid)
endpoint_urlstring (uri)
event_typesarray<string>
payload_versionobject
stateobject
active paused revoked
secret_generationinteger
issued_scopesarray<string>
executionobject
Who executed the request: the app, version, installation and store. Field names here are camelCase.
appIdstring (uuid)
versionIdstring (uuid)
installationIdstring (uuid)
storeIdstring (uuid)
requestIdstring (uuid)
generationinteger
routeEpochinteger
appAuthEpochinteger
grantRevisioninteger
metaobjectrequired
request_idstring (uuid)
The request ID; include it in any support request.

Errors

HTTPCodeMeaning
403SUBSCRIPTION_EXPANSION_REQUIRES_RECONSENTAdding topics requires a new subscription.
400INVALID_STATEThe state can only be active or paused.

Shared codes are listed in Errors.

    ↑↓ moveEnter openEsc close