Integrations
list_integration_activity_logs
readList integration activity logs
Find why products or orders of one integration failed, leaving out the errors the platform is expected to answer.
Overview
Lists the requests between Sign Customiser and one commerce integration of the connected Store, newest first, as the merchant admin integration Activity tab shows them: each request direction, the line the admin shows, its HTTP status and duration, what caused it and the storefront page the shopper was on. Filters narrow it by customiser and by status: errors for every 4xx or 5xx answer, actionable_errors for only the unexpected ones. No credential, request body or header is returned. It requires the integrations:read scope and has no side effects.
Permission
Requires theintegrations:readpermission. A connection without it answersinsufficient_scopenaming the permission to approve.
Annotations
Prerequisites
- An integration id from list_integrations.
- A merchant has connected this store and approved the integrations:read scope.
Arguments
The integration id, from list_integrations.
How many requests to return per page, between 1 and 100. Defaults to 20.
The opaque next_cursor value from the previous page, sent back with the same integration and filters.
Optional filters. An unknown filter is rejected, never ignored.
Only requests of this customiser.
errors for every 4xx or 5xx answer, actionable_errors for only the unexpected ones (closed).
One of: errors, actionable_errors
Result
Up to `limit` logged requests of the integration, newest first, plus the cursor for the next page.
The page of logged requests, newest first.
The request direction: request:outgoing or request:incoming, or the older outgoing-request and incoming-request names on old rows. Expected to grow.
The line the merchant admin shows for the request.
The HTTP status of the request, or null.
How long the request took, or null.
What sent or caused the request, or null.
One of: api_key, integration, webhook
The last four characters of an API key; null for every other kind.
The storefront page the shopper was on when the request started, or null.
One of: window, parent, referrer, unavailable
One of: available, unavailable
Error cases
The connection was approved without integrations:read.
The cursor was altered or reused for a different integration, Store or filters; restart with no cursor.
customiser_id is not an integer from 1 to 2147483647, status is not errors or actionable_errors, or limit is not an integer from 1 to 100.
No integration with that id belongs to this store. Call list_integrations to find a valid id.
Remove the filter named in parameter. This tool forwards unknown filter names so the API can refuse them explicitly.
Unexpected failures only
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "list_integration_activity_logs",
"arguments": {
"integration_id": 31,
"limit": 1,
"filter": {
"status": "actionable_errors"
}
}
}
}{
"jsonrpc": "2.0",
"id": 1,
"result": {
"structuredContent": {
"request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t",
"store": {
"id": 12,
"name": "Demo Signs"
},
"integration_id": 31,
"activity_logs": [
{
"id": 88123,
"event": "request:outgoing",
"description": "Create product on Shopify",
"status_code": 422,
"duration_ms": 640,
"causer": {
"kind": "integration",
"name": "Main store",
"last_four": null
},
"storefront_page": null,
"created_at": "2026-11-14T09:30:00Z"
}
],
"pagination": {
"has_more": false,
"next_cursor": null
}
}
}
}An integration of another store (error)
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "list_integration_activity_logs",
"arguments": {
"integration_id": 999
}
}
}{
"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."
}
}
}
}