scrapewise_run_group_delivery_webhook_test
Sends one signed PING to the group's webhook URL right now and answers what the receiver said, so you can
check your endpoint and your signature check without waiting for a real event. The body is fixed:
{"event":"PING","groupId":...,"deliveryId":...,"computedAt":...}, with the same headers as real events
(X-Scrapewise-Event: PING, X-Scrapewise-Delivery, X-Scrapewise-Timestamp, X-Scrapewise-Signature). It is
not queued and not retried. At most one test per minute per group.
Args:
- id (string, path, required): the group's id (you must own the group, and it must have a webhook).
- customerRef (string, query, optional): only for a Scrapewise admin key while the admin works in
another customer's account (Take Over): that customer's customerUniqueRef. Leave it out otherwise.
Returns:
{delivered: true when the receiver answered 2xx, deliveryId, httpStatus (null when no answer), error
(timeout, refused address, HTTP status text)}.
Examples:
- Use when: "test the webhook of group {id}" right after creating it.
- Use when: the webhook shows FAILED or DEAD deliveries and the receiver was fixed.
- Don't use when: you want real data -> wait for FILE_READY / DAY_* or get the delivery status.
Error Handling:
- 404 WEBHOOK_NOT_FOUND: the group has no webhook. 429 WEBHOOK_TEST_LIMIT: one test per minute.
- 403 WEBHOOK_OWNER_ONLY; 503 WEBHOOK_UNAVAILABLE: webhooks are not available on this server right now.
- 409 TAKE_OVER_ACTIVE; 401 Unauthorized; 500 INTERNAL.[runtime hint] This tool returns JSON-as-text — its response shape is dynamic (per-scraper itemsConfig, file binary, etc.) so the MCP outputSchema is omitted. Do not rely on the presence of any specific field in the response; treat the result as a string-or-object blob and parse defensively.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"id": "<id>"
},
"name": "scrapewise_run_group_delivery_webhook_test"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | the group's id (you must own the group, and it must have a webhook). | |
| customerRef | No | Admin keys in Take Over only: the customerUniqueRef of the customer the admin works for. Required then; leave it out otherwise. |