Webhook subscriptions

Delete a subscription

Revokes the subscription and stops webhooks.

DELETE/stores/{storeId}/v1/webhook-subscriptions/{id}

No scope required

Path parameters

idstring (uuid)required

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.

Request

cURL

curl -X DELETE "https://larm.sa/stores/$STORE_ID/v1/webhook-subscriptions/8d1f0c2a-4b3e-4a5f-9c6d-7e8f9a0b1c2d" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Node.js

const response = await fetch(`https://larm.sa/stores/${storeId}/v1/webhook-subscriptions/8d1f0c2a-4b3e-4a5f-9c6d-7e8f9a0b1c2d`, {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${accessToken}`,
  },
})
if (!response.ok) throw new Error((await response.json()).error.code)
const { data, meta } = await response.json()

Python

import requests

response = requests.delete(
    f"https://larm.sa/stores/{store_id}/v1/webhook-subscriptions/8d1f0c2a-4b3e-4a5f-9c6d-7e8f9a0b1c2d",
    headers={"Authorization": f"Bearer {access_token}"},
    timeout=15,
)
response.raise_for_status()
data = response.json()["data"]

PHP

$ch = curl_init("https://larm.sa/stores/{$storeId}/v1/webhook-subscriptions/8d1f0c2a-4b3e-4a5f-9c6d-7e8f9a0b1c2d");
curl_setopt_array($ch, [
  CURLOPT_CUSTOMREQUEST => 'DELETE',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . $accessToken],
]);
$data = json_decode(curl_exec($ch), true)['data'];

Response 200

JSON

{
  "data": {
    "id": "8d1f0c2a-4b3e-4a5f-9c6d-7e8f9a0b1c2d",
    "endpoint_url": "https://app.example.com/larm/webhooks",
    "event_types": [
      "order.created",
      "order.paid"
    ],
    "payload_version": 1,
    "state": "revoked",
    "secret_generation": 1,
    "issued_scopes": [
      "orders:read"
    ]
  },
  "execution": {
    "appId": "1f2e3d4c-5b6a-4978-8695-a4b3c2d1e0f9",
    "versionId": "9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d",
    "installationId": "c7e4a1f2-6b3d-4e8a-9c05-1d2f3a4b5c6d",
    "storeId": "5b1d7a62-0c4e-4f38-9a51-2e7b3c9d8f10",
    "requestId": "3f0c2b8e-7a51-4c1e-9d0a-5b6f1e2d4c3a",
    "generation": 1,
    "routeEpoch": 4,
    "appAuthEpoch": 1,
    "grantRevision": 2
  },
  "meta": {
    "request_id": "3f0c2b8e-7a51-4c1e-9d0a-5b6f1e2d4c3a"
  }
}