Creates a public HTTPS URL that records every request sent to it (any method, any sub-path, headers, query and body), so you can receive webhooks and callbacks without a server of your own. Use it when something needs a URL to call back – a payment provider, a CI job, an OAuth or API integration, your own code under test – then give that URL to the sender and read what arrived with list_webhook_requests. Returns the capture URL, the bin id and a secret key (pass both to the other webhook tools), a private page link for a person to watch requests live in a browser, and the expiry (7 days). The URL answers every request with HTTP 200 {"ok":true} unless you set response_status/response_type/response_body.
| Argument | Type | Description |
|---|---|---|
| name | string | Optional label for the bin, e.g. what it is for (at most 80 characters). |
| response_status | integer | HTTP status the URL answers with. Default 200. |
| response_type | string | Content-Type of the answer. Default application/json. |
| response_body | string | Body of the answer. Default {"ok":true}. |
Tool definition (tools/list)
{
"name": "create_webhook_url",
"title": "Create a webhook URL",
"description": "Creates a public HTTPS URL that records every request sent to it (any method, any sub-path, headers, query and body), so you can receive webhooks and callbacks without a server of your own. Use it when something needs a URL to call back – a payment provider, a CI job, an OAuth or API integration, your own code under test – then give that URL to the sender and read what arrived with list_webhook_requests. Returns the capture URL, the bin id and a secret key (pass both to the other webhook tools), a private page link for a person to watch requests live in a browser, and the expiry (7 days). The URL answers every request with HTTP 200 {\"ok\":true} unless you set response_status/response_type/response_body.",
"inputSchema": {
"properties": {
"name": {
"description": "Optional label for the bin, e.g. what it is for (at most 80 characters).",
"type": "string"
},
"response_status": {
"description": "HTTP status the URL answers with. Default 200.",
"minimum": 200,
"maximum": 599,
"type": "integer"
},
"response_type": {
"description": "Content-Type of the answer. Default application/json.",
"enum": [
"application/json",
"text/plain",
"application/xml",
"text/xml",
"text/csv",
"application/x-www-form-urlencoded"
],
"type": "string"
},
"response_body": {
"description": "Body of the answer. Default {\"ok\":true}.",
"type": "string"
}
},
"type": "object"
},
"annotations": {
"title": "Create a webhook URL",
"readOnlyHint": false,
"destructiveHint": false,
"idempotentHint": false,
"openWorldHint": true
}
}