# List webhook subscription activity logs (`list_webhook_subscription_activity_logs`)

Lists the deliveries of one webhook subscription of the connected Store, newest first, as the merchant admin webhook Activity tab shows them: each request direction, the line the admin shows, the HTTP status the endpoint answered and how long it took, what caused it and the storefront page the shopper was on. Filters narrow it by customiser and by status: errors for a 4xx or 5xx answer or no answer. The signing secret, request body and headers are never returned. It requires the webhooks:read scope and has no side effects.

- Source URL: https://www.signcustomiser.com/help/mcp/tools/list_webhook_subscription_activity_logs/
- Markdown URL: https://www.signcustomiser.com/help/mcp/tools/list_webhook_subscription_activity_logs.md
- MCP endpoint: https://mcp.signcustomiser.com
- Required scope: `webhooks:read`
- Behaviour: read

## Purpose

Find why a webhook endpoint stopped receiving deliveries, and which customiser the failed deliveries came from.

## Annotations

| Hint | Value |
| --- | --- |
| readOnlyHint | true |
| destructiveHint | false |
| idempotentHint | true |
| openWorldHint | false |

## Prerequisites

- A webhook subscription id from list_webhook_subscriptions.
- A merchant has connected this store and approved the webhooks:read scope.

## Arguments

| Property | Type | Required | Description |
| --- | --- | --- | --- |
| `webhook_id` | integer | yes | The webhook subscription id, from list_webhook_subscriptions. |
| `limit` | integer | no | How many deliveries to return per page, between 1 and 100. Defaults to 20. |
| `cursor` | string | no | The opaque next_cursor value from the previous page, sent back with the same subscription and filters. |
| `filter` | object | no | Optional filters. An unknown filter is rejected, never ignored. |
| `filter.customiser_id` | integer | no | Only deliveries of this customiser. |
| `filter.status` | string | no | errors for a 4xx or 5xx answer or no answer (closed). One of: `errors`. |

## Result

Up to `limit` deliveries of the subscription, newest first, plus the cursor for the next page.

| Property | Type | Required | Description |
| --- | --- | --- | --- |
| `request_id` | string | yes |  |
| `store` | object | yes |  |
| `store.id` | integer | yes |  |
| `store.name` | string | yes |  |
| `webhook_id` | integer | yes |  |
| `activity_logs` | array of object | yes | The page of deliveries, newest first. |
| `activity_logs[].id` | integer | yes |  |
| `activity_logs[].event` | string or null | no | The request direction: request:outgoing or request:incoming, or the older outgoing-request and incoming-request names on old rows. Expected to grow. |
| `activity_logs[].description` | string | yes | The line the merchant admin shows for the request. |
| `activity_logs[].status_code` | integer or null | no | The HTTP status of the request, or null. |
| `activity_logs[].duration_ms` | integer or null | no | How long the request took, or null. |
| `activity_logs[].causer` | object or null | no | What sent or caused the request, or null. |
| `activity_logs[].causer.kind` | string | yes | One of: `api_key`, `integration`, `webhook`. |
| `activity_logs[].causer.name` | string or null | no |  |
| `activity_logs[].causer.last_four` | string or null | no | The last four characters of an API key; null for every other kind. |
| `activity_logs[].storefront_page` | object or null | no | The storefront page the shopper was on when the request started, or null. |
| `activity_logs[].storefront_page.url` | string or null | no |  |
| `activity_logs[].storefront_page.origin` | string or null | no |  |
| `activity_logs[].storefront_page.source` | string | yes | One of: `window`, `parent`, `referrer`, `unavailable`. |
| `activity_logs[].storefront_page.availability` | string | yes | One of: `available`, `unavailable`. |
| `activity_logs[].storefront_page.captured_at` | string or null | no |  |
| `activity_logs[].created_at` | string | yes |  |
| `pagination` | object | yes |  |
| `pagination.has_more` | boolean | yes |  |
| `pagination.next_cursor` | string or null | no |  |

## Error cases

| Code | Recovery |
| --- | --- |
| `insufficient_scope` | The connection was approved without webhooks:read. |
| `invalid_cursor` | The cursor was altered or reused for a different subscription, Store or filters; restart with no cursor. |
| `invalid_parameter` | customiser_id is not an integer from 1 to 2147483647, status is not errors, or limit is not an integer from 1 to 100. |
| `resource_not_found` | No webhook subscription with that id belongs to this store. Call list_webhook_subscriptions to find a valid id. |
| `unknown_filter` | Remove the filter named in parameter. This tool forwards unknown filter names so the API can refuse them explicitly. |

## Example: Failed deliveries

Request:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_webhook_subscription_activity_logs",
    "arguments": {
      "webhook_id": 7,
      "limit": 1,
      "filter": {
        "status": "errors"
      }
    }
  }
}
```

Response:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "structuredContent": {
      "request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t",
      "store": {
        "id": 12,
        "name": "Demo Signs"
      },
      "webhook_id": 7,
      "activity_logs": [
        {
          "id": 88140,
          "event": "request:outgoing",
          "description": "Sent order:created webhook",
          "status_code": 500,
          "duration_ms": 2110,
          "causer": {
            "kind": "webhook",
            "name": "https://example.com/webhooks/sign-customiser",
            "last_four": null
          },
          "storefront_page": null,
          "created_at": "2026-11-14T09:30:00Z"
        }
      ],
      "pagination": {
        "has_more": false,
        "next_cursor": null
      }
    }
  }
}
```

## Example: A webhook subscription of another store (error)

Request:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_webhook_subscription_activity_logs",
    "arguments": {
      "webhook_id": 999
    }
  }
}
```

Response:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "isError": true,
    "structuredContent": {
      "error": {
        "code": "resource_not_found",
        "title": "Resource not found",
        "detail": "The requested resource does not exist or does not belong to the authenticated store.",
        "recovery": "The identifier does not exist in this store. Use the matching list tool to rediscover a valid id."
      }
    }
  }
}
```
