Update Addresses

Add or remove addresses from a webhook subscription.

PATCH /beta/evm/subscriptions/webhooks/{webhookId}/addresses

cURL

add_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"
  ]
}
'

400

Invalid URL: UUID parsing failed: invalid group length in group 4: expected 12, found 11

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

200

Addresses updated successfully. No response body.