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: <x-sim-api-key>' \
  --data '
{
  "add_addresses": [
    "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
    "0x1234567890123456789012345678901234567890"
  ]
}
'
"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.

Headers

​
X-Sim-Api-Key
string
required

Used for authenticating requests. Provide an API key with a purpose of Sim API. See Authentication.

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.