{"uid":"cap_GwCNNUsuHtcBeVVFyzHEW","slug":"x402-gateway-webhook-hook-event-poller-6d07a4aa","name":"x402-gateway: Webhook Hook Event Poller","description":"31 tools. Pay per call. No accounts. No logins. No API keys. Blockchain data, stablecoin verification, ZK proofs, QR & diagram rendering, LLM chat, gift cards, short links — settled in USDC on Base via the x402 payment protocol and Coinbase CDP facilitator.","url":"https://x402.freeq.one/hooks/:id/events?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"clear":{"type":"boolean","description":"True to empty the hook after this read. Default false (events kept for re-polling)."}}},"responseSchema":{"type":"json","example":{"result":{}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_tbPguiOdmbRajRjphlXNI","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Poll or drain queued POST events captured by a previously created single-use webhook hook URL","exampleAgentPrompt":"Check my webhook hook abc123 for any events that have been captured, and clear the queue after reading so I start fresh next time.","exampleUseCases":[{"title":"Drain async callback after OAuth flow","prompt":"I set up a single-use webhook with hook ID xyz789 to catch an OAuth callback — can you read whatever events came in and then clear the queue?"},{"title":"Poll hook for third-party POST confirmation","prompt":"Check hook ID hook_abc456 to see if the payment processor has POSTed a confirmation yet. Don't clear it yet — I may want to re-read."},{"title":"Retrieve webhook payload for debugging","prompt":"My integration test just triggered a POST to my hook endpoint hook_def999 — pull back the captured events so I can inspect the payload."}],"resultDescription":"Returns a JSON object containing all queued events that were POSTed to the specified hook URL since it was created or last cleared. If 'clear' is true, the event queue is emptied after reading. The result wraps event payloads in a result object.","failureModes":["Invalid or expired hook ID returns empty or error result","Hook never received any POST — result contains empty event list","clear=true is non-idempotent: calling again after clearing returns no events","Rate limiting or payment failure if USDC balance is insufficient","Hook URL may have a lifetime limit — stale IDs may return no data"],"whenToPreferThis":"Use this endpoint when you have already created a webhook hook URL via the x402-gateway webhook_catch endpoint and need to retrieve or drain the events it has captured. Ideal for polling-based async workflows where a third party POSTs data to a temporary URL and you need to read it back. Prefer over persistent webhook infrastructure when you need a quick, stateless, pay-per-call event capture pattern with no account setup.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T06:37:18.396Z","isFirstParty":false,"canonicalSlug":"x402-gateway-webhook-hook-event-poller-6d07a4aa"}