One of a store’s webhooks

GET/stores/{storeId}/webhooks/{webhookId}

Store member

Without its secret.

SDK method: collector.getStoreWebhook()
Key scopes: store:webhooks:read
Headers: X-Request-Id

Path parameters

storeIdstring (uuid)required
webhookIdstring (uuid)required

Responses

200OKThe webhook.

object

webhookWebhookrequired

5Errors401 · 403 · 404 · 429 · 500

401
unauthorized
unauthorized: Not signed in (no session or token, or an expired one).
403
forbidden
forbidden: Store staff can’t manage webhooks.
404
not_found
not_found: Nothing at that address.
429
rate_limited temporarily_blocked
rate_limited: Over the caller’s limit: the per-minute burst or the per-day quota (RateLimit headers; wait Retry-After seconds).
temporarily_blocked: Too many refused requests in a row: blocked for a while (Retry-After says how long).
500
internal
internal: Something went wrong on our side (quote the requestId).

curl 'https://api.collection.id/v1/stores/0b4f3b1e-6c1a-4f5e-9f0e-1f2a3b4c5d6e/webhooks/1c9e8b7a-6d5f-4e3c-9b2a-1f0e9d8c7b6a' \
  -H "Authorization: Bearer $COLLECTOR_TOKEN"

{
  "webhook": {
    "id": "1c9e8b7a-6d5f-4e3c-9b2a-1f0e9d8c7b6a",
    "kind": "store",
    "storeId": "0b4f3b1e-6c1a-4f5e-9f0e-1f2a3b4c5d6e",
    "url": "https://pos.example.com/collector/webhooks",
    "description": "Point of sale: holds and sales",
    "events": [
      "hold.requested",
      "hold.cancelled",
      "listing.sold"
    ],
    "status": "active",
    "disabledAt": null,
    "disabledReason": null,
    "secretHint": "whsec_…Q2xw",
    "previousSecretExpiresAt": null,
    "createdBy": {
      "id": "0e6b1c52-8f43-4b8e-9d0c-5a7e2f1b3c4d",
      "label": "Carol"
    },
    "createdAt": "2026-10-12T15:04:05.123Z",
    "updatedAt": "2026-10-12T15:04:05.123Z",
    "health": {
      "failureStreak": 0,
      "failingSince": null,
      "lastSuccessAt": "2026-10-12T15:04:05.123Z",
      "lastFailureAt": null
    }
  }
}

Responses

200OKThe webhook.

object

webhookWebhookrequired

5Errors401 · 403 · 404 · 429 · 500

401
unauthorized
unauthorized: Not signed in (no session or token, or an expired one).
403
forbidden
forbidden: Store staff can’t manage webhooks.
404
not_found
not_found: Nothing at that address.
429
rate_limited temporarily_blocked
rate_limited: Over the caller’s limit: the per-minute burst or the per-day quota (RateLimit headers; wait Retry-After seconds).
temporarily_blocked: Too many refused requests in a row: blocked for a while (Retry-After says how long).
500
internal
internal: Something went wrong on our side (quote the requestId).

{ "webhook": { "id": "1c9e8b7a-6d5f-4e3c-9b2a-1f0e9d8c7b6a", "kind": "store", "storeId": "0b4f3b1e-6c1a-4f5e-9f0e-1f2a3b4c5d6e", "url": "https://pos.example.com/collector/webhooks", "description": "Point of sale: holds and sales", "events": [ "hold.requested", "hold.cancelled", "listing.sold" ], "status": "active", "disabledAt": null, "disabledReason": null, "secretHint": "whsec_…Q2xw", "previousSecretExpiresAt": null, "createdBy": { "id": "0e6b1c52-8f43-4b8e-9d0c-5a7e2f1b3c4d", "label": "Carol" }, "createdAt": "2026-10-12T15:04:05.123Z", "updatedAt": "2026-10-12T15:04:05.123Z", "health": { "failureStreak": 0, "failingSince": null, "lastSuccessAt": "2026-10-12T15:04:05.123Z", "lastFailureAt": null } } }