Create Subscription

Create Subscription - Webhooks API

Create Subscription - Creates a webhook subscription for a list of addresses and chains

Create Subscription - [Value: 20CU]
Creates a subscription. When a subscribed address moves anything, a signed POST with the decoded transaction is sent to your callback URL. Returns 201
POST https://lb.drpc.live/lambda/{key}/v1/webhooks/subscriptions
Use cases

Use cases

  • Get a signed POST when a watched address sends or receives
  • Get decoded transfers with token metadata and USD values
  • Receive Ethereum validator rewards, payouts and status changes
Constraints

Constraints

  • Up to 50 subscriptions, 10,000 addresses each
  • Token contracts and blocklisted addresses return 422
  • Staking: create-only; chain_ids empty or with ethereum
Get started
Unlock Access to 100+ chains
Boost your app's speed and reliability with dRPC - get your access API key

Language

Request
Examples
curl --request POST \
  --url https://lb.drpc.live/lambda/{key}/v1/webhooks/subscriptions \
  --header 'accept: application/json' \
  --header 'content-type: application/json' \
  --data '{
  "callback_url": "https://example.com/hooks/lambda",
  "addresses": [
    "0x04fC43d86DEee3185B77f0D520D8932462814e02"
  ],
  "chain_ids": [
    "ethereum",
    "base"
  ],
  "filters": {}
}'
Copy
Response
200
{
  "id": "0450d9f4-304f-420f-9b49-3625d9c52c1f",
  "callback_url": "https://example.com/hooks/lambda",
  "status": "enabled",
  "chain_ids": [
    "ethereum",
    "base"
  ],
  "filters": {},
  "address_count": 1,
  "created_at": "2026-09-21T12:52:46.024339Z",
  "updated_at": "2026-09-21T12:52:46.024339Z"
}
Copy

Path params

Parameters
keystring
[Required] Your dRPC API key

Query params

ParametersThis method does not accept any parameters.

Request params

Parametersobject
object
callback_urlstring
[Required] HTTPS URL on a public host. Private and reserved IPs, localhost and internal suffixes are rejected
addressesarray_of_strings
[Required] 1 to 100 addresses per call; add the rest with Add / Remove Addresses. Hex addresses are lowercased
chain_idsarray_of_strings
Up to 50 chain slugs: ethereum, base, polygon, bsc, arbitrum, optimism, avalanche, monad. Omit or send [] for all chains
filtersobject
{}, {"include_spam": true}, {"event_kinds": ["staking"]}, or both keys. Any other key is rejected with 422

Response

200

Response params

object
idstring
[Required] Subscription id (UUID)
callback_urlstring
[Required] HTTPS URL that receives signed POST deliveries
statusstring
[Required] Only enabled subscriptions get deliveries
chain_idsarray_of_strings
[Required] Lowercase chain slugs. [] means every supported chain, including future ones
filtersobject
[Required] Subscription filters. {} when none are set
address_countinteger
[Required] How many addresses the subscription watches. The list itself is never inlined; use List Addresses
created_atstring
[Required] Creation time, ISO 8601
updated_atstring
[Required] Last update time, ISO 8601