Create WebHook

This sample code demonstrate how you can create a webhook, as documented here at: Using Webhooks

API used: POST /v1/btc/main/hooks

require __DIR__ . '/../bootstrap.php'; $webHook = new \BlockCypher\Api\WebHook(); $webHook->setUrl("http://requestb.in/rwp6jirw?uniqid=" . uniqid()); $webHook->setEvent('unconfirmed-tx'); $webHook->setHash('2b17f5589528f97436b5d563635b4b27ca8980aa20c300abdc538f2a8bfa871b'); /// For Sample Purposes Only. $request = clone $webHook; $webHookClient = new \BlockCypher\Client\WebHookClient($apiContexts['BTC.main']); /// Create WebHook try { $output = $webHookClient->create($webHook); } catch (Exception $ex) { ResultPrinter::printError("Created WebHook", "WebHook", null, $request, $ex); exit(1); } ResultPrinter::printResult("Created WebHook", "WebHook", $output->getId(), $request, $output); return $output;

WebHook request


Fill up the basic information that is required for the webhook The URL should be actually accessible over the internet. Having a localhost here would not work.

There is an open source tool http://requestb.in/ that allows you to receive any web requests to a url given there.

The transaction or block associated with the event you subscribed to will be POSTed to the provided URL. The POST request will also include a X-EventType and a X-EventId HTTP header specifying the type of and id of the webhook which triggered the request. X-Eventtype: unconfirmed-tx X-Eventid: f1cef7d6-cfd9-459c-8ebc-42226ae2b1a7

Event Types

Event types correspond to what kind of notifications you want to receive on the given URL. Complete event list.