Webhook subscriptions
List webhook subscription activity logs
Lists the deliveries of one webhook subscription of the authenticated
Store, as the merchant admin's webhook activity shows them: newest first
by created_at, with the newer id first when two deliveries share a
time. Requires webhooks:read.
Overview
Follow links.next while
pagination.has_more is true, sending each cursor back unchanged with
the same filters. A subscription of another Store answers the same 404 as
one that never existed.
Each entry gives the status code and duration of the delivery, never the
request or response itself. Activity is kept for seven days.
filter[customiser_id] keeps the deliveries about one customiser. A
customiser that is not one of the Store's matches no deliveries.
filter[status]=errors keeps the deliveries that got a 4xx or 5xx
status or no answer.
Authorisation
Bearer token required. Include it in the Authorization header.
Required scope: webhooks:read
Path parameters
The canonical subscription ID.
Example: 1
Query parameters
Page size from 1 to 100. Defaults to 20.
Example: 20
The opaque next_cursor from a previous page.
Example: eyJ2IjoxfQ
Only return deliveries about this customiser.
Example: 42
Only return failed deliveries (`errors`).
Example: errors
curl https://web.signcustomiser.com/api/v3/webhook-subscriptions/1/activity-logs?limit=20&cursor=eyJ2IjoxfQ&filter%5Bcustomiser_id%5D=42&filter%5Bstatus%5D=errors \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_API_TOKEN'{
"data": [
{
"object": "activity_log",
"id": 88125,
"event": "request:outgoing",
"description": "Webhook request sent",
"status_code": 410,
"duration_ms": 212,
"causer": {
"kind": "webhook",
"name": null,
"last_four": null
},
"storefront_page": {
"url": "https://example.com/products/neon-sign",
"origin": "https://example.com",
"source": "window",
"availability": "available",
"captured_at": "2026-11-14T09:31:58Z"
},
"created_at": "2026-11-14T09:32:00Z"
}
],
"pagination": {
"has_more": false,
"next_cursor": null
},
"links": {
"self": "https://web.signcustomiser.com/api/v3/webhook-subscriptions/42/activity-logs",
"documentation": "https://www.signcustomiser.com/help/api/",
"next": null
},
"meta": {
"api_version": "v3",
"request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
}
}{
"type": "https://www.signcustomiser.com/help/api/problems/missing_api_key",
"title": "Missing API key",
"status": 401,
"code": "missing_api_key",
"detail": "Provide a store API key as a bearer token.",
"request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
}{
"type": "https://www.signcustomiser.com/help/api/problems/insufficient_scope",
"title": "Insufficient scope",
"status": 403,
"code": "insufficient_scope",
"detail": "This operation requires the webhooks:read scope.",
"required_scopes": [
"webhooks:read"
],
"granted_scopes": [
"webhooks:write"
],
"request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
}{
"type": "https://www.signcustomiser.com/help/api/problems/resource_not_found",
"title": "Resource not found",
"status": 404,
"code": "resource_not_found",
"detail": "The requested resource does not exist or does not belong to the authenticated store.",
"request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
}{
"type": "https://www.signcustomiser.com/help/api/problems/invalid_parameter",
"title": "Invalid query parameter",
"status": 422,
"code": "invalid_parameter",
"detail": "The filter[status] value must be one of: errors.",
"errors": [
{
"parameter": "filter[status]",
"code": "unsupported_value",
"detail": "The filter[status] value must be one of: errors.",
"allowed_values": [
"errors"
]
}
],
"request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
}{
"type": "https://www.signcustomiser.com/help/api/problems/rate_limited",
"title": "Too many requests",
"status": 429,
"code": "rate_limited",
"detail": "You have exceeded the request limit for this API key.",
"retry_after": 60,
"request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
}