Skip to main content
PATCH
/
beta
/
evm
/
subscriptions
/
webhooks
/
{webhookId}
/
addresses
curl --request PATCH \ --url https://api.sim.dune.com/beta/evm/subscriptions/webhooks/{webhookId}/addresses \ --header 'Content-Type: application/json' \ --header 'X-Sim-Api-Key: <api-key>' \ --data ' { "add_addresses": [ "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb", "0x1234567890123456789012345678901234567890" ] } '
"Invalid URL: UUID parsing failed: invalid group length in group 4: expected 12, found 11"

Documentation Index

Fetch the complete documentation index at: https://docs.sim.dune.com/llms.txt

Use this file to discover all available pages before exploring further.

Add or remove individual addresses from a webhook subscription without replacing the entire list. This is useful when you want to incrementally manage your subscribed addresses.
If you need to replace the entire address list at once, use the Replace Webhook Addresses endpoint instead.

​
Example Use Cases

​
Add New Addresses

Add one or more addresses to your existing subscription: 
{
  "add_addresses": [
    "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
    "0x1234567890123456789012345678901234567890"
  ]
}

​
Remove Addresses

Remove addresses that you no longer want to monitor: 
{
  "remove_addresses": [
    "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C"
  ]
}

​
Add and Remove in One Request

You can add and remove addresses in the same request. The removal happens first, followed by the additions.
{
  "add_addresses": [
    "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb"
  ],
  "remove_addresses": [
    "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C"
  ]
}
This endpoint only manages addresses. To update other webhook properties like name, URL, or status, use the Update Webhook endpoint.

Authorizations

​
X-Sim-Api-Key
string
header
required

API key for authentication. Obtain your key from the Dune dashboard at sim.dune.com.

Path Parameters

​
webhookId
string<uuid>
required

The unique identifier of the webhook.

Body

application/json
​
add_addresses
string[]

Addresses to add to the subscription list.

EVM address.

​
remove_addresses
string[]

Addresses to remove from the subscription list.

EVM address.

Response

Addresses updated successfully. No response body.