Skip to main content
You’ll need a project and API key from the Uniblock dashboard before setting up a webhook.
Webhooks let you receive real-time notifications whenever specific blockchain events occur — no polling required. Uniblock sends a signed HTTP POST request to your server each time a matching event fires, covering transactions, token transfers, contract events, and new blocks.

​
Webhook setup

Navigate to the Webhooks section in the Uniblock dashboard and click Create Webhook. A four-step form expands inline.
1

Add webhook information

Give the webhook a name and description — these are for your reference in the dashboard only and don’t affect delivery.Enter your webhook URL: the public HTTPS endpoint on your server that will receive POST requests. Hit the Test button to send a sample payload and confirm the URL is reachable before proceeding.
If you don’t have a server yet, use webhook.site or typedwebhook.tools to get a temporary URL for testing.
2

Select provider and network

Choose the provider you want to deploy the webhook through. Each provider supports a different set of networks, so the network list updates based on your selection.Select the network (chain) you want to monitor — for example, Ethereum Mainnet, Polygon, or Base.
3

Select a webhook type

Choose how to define the webhook:
  • Webhook templates — pre-built configurations for common use cases (popular token contracts, standard ABIs). Pick a template to auto-fill most fields.
  • Custom webhook — full flexibility; you fill in all fields manually. Use this for any contract or event not covered by a template.
4

Add events and filters

This step narrows which on-chain activity triggers the webhook:
  • Address activity — monitor one or more wallet or contract addresses. Add optional transaction filters (e.g. minimum value, direction) to reduce noise.
  • Contract event — select a specific ABI event to listen for (required). Add event filters to match only certain parameter values (optional).
  • Solana address activity — same as address activity but scoped to Solana. Add Solana-specific transaction filters as needed.
5

Deploy

Click Deploy. The webhook becomes active immediately and appears in your active webhooks list. Uniblock begins forwarding matching events to your URL as they occur on-chain.

​
Configuration fields

Keep in mind:
  • Your webhook URL must be publicly reachable and able to handle the expected POST volume.
  • Validate the X-Uniblock-Signature header on incoming requests to confirm payloads are from Uniblock.

​
Supported chains

​
Webhook endpoints