Register Premium Webhook
sap_premium_webhook_registerRegisters an HTTPS webhook target for signed premium event delivery. The session must be active (activated via sap_premium_activate_session). The target URL must be HTTPS, reachable, and not a private/localhost endpoint in production. Events are filtered to the exact event ids listed in the request.
SAP MCP execution guidance: Intent: local-signer write workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x402 natively. Routing: paid hosted call; call sap_estimate_tool_cost first, then use sap_payments_call_paid_tool if the runtime cannot handle x402 natively. Signer boundary: hosted reads/builders never receive keypair bytes; value-moving results must be finalized locally when signing is required.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| events | Yes | Exact event ids to deliver, from the capability delivery contract. | |
| sessionId | Yes | Active premium session id. | |
| targetUrl | Yes | HTTPS webhook endpoint owned by the buyer. Localhost and private network URLs are rejected in production. | |
| signingPublicKey | No | Optional buyer public key for webhook signature verification. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| subscription | Yes | Webhook subscription record with subscriptionId, targetUrl, events, and delivery stats. |