Replace webhook addresses
curl --request PUT \
--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 '
{
"addresses": [
"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
"0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C"
]
}
'const options = {
method: 'PUT',
headers: {'X-Sim-Api-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
addresses: [
'0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045',
'0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C'
]
})
};
fetch('https://api.sim.dune.com/beta/evm/subscriptions/webhooks/{webhookId}/addresses', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.sim.dune.com/beta/evm/subscriptions/webhooks/{webhookId}/addresses"
payload = { "addresses": ["0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045", "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C"] }
headers = {
"X-Sim-Api-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)Invalid URL: UUID parsing failed: invalid group length in group 4: expected 12, found 11{
"error": "Too many requests. Please contact sales@dune.com to increase your limit."
}Subscriptions
Replace Webhook Addresses
Replace the entire address list for a webhook subscription.
PUT
/
beta
/
evm
/
subscriptions
/
webhooks
/
{webhookId}
/
addresses
Replace webhook addresses
curl --request PUT \
--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 '
{
"addresses": [
"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
"0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C"
]
}
'const options = {
method: 'PUT',
headers: {'X-Sim-Api-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
addresses: [
'0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045',
'0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C'
]
})
};
fetch('https://api.sim.dune.com/beta/evm/subscriptions/webhooks/{webhookId}/addresses', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.sim.dune.com/beta/evm/subscriptions/webhooks/{webhookId}/addresses"
payload = { "addresses": ["0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045", "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C"] }
headers = {
"X-Sim-Api-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)Invalid URL: UUID parsing failed: invalid group length in group 4: expected 12, found 11{
"error": "Too many requests. Please contact sales@dune.com to increase your limit."
}Replaces the entire list of subscribed addresses for a webhook. The new list completely overwrites the existing addresses.
Use this endpoint when you want to:
- Replace the entire address list with a new set
- Reset the subscription to monitor a different set of addresses
- Perform a bulk update of all addresses at once
This endpoint replaces ALL existing addresses.
Any addresses not included in the new list will be removed from the subscription.
If you only need to add or remove specific addresses without replacing the entire list, use the Update Addresses endpoint instead.
Authorizations
API key for authentication. Obtain your key from the Dune dashboard at sim.dune.com.
Path Parameters
The unique identifier of the webhook.
Body
application/json
New list of addresses to monitor. This replaces the existing list entirely.
EVM address.
Response
Addresses replaced successfully. No response body.
Was this page helpful?