> ## 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.

# Replace Webhook Addresses

> Replace the entire address list for a webhook subscription.

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

<Warning>
  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](/evm/subscriptions/update-webhook-addresses) endpoint instead.
</Warning>


## OpenAPI

````yaml /openapi.json PUT /beta/evm/subscriptions/webhooks/{webhookId}/addresses
openapi: 3.0.3
info:
  title: Sim API
  description: >-
    The Sim API by Dune provides real-time blockchain data across EVM and SVM
    chains. Access token balances, transaction history, on-chain activity, DeFi
    positions, NFT collectibles, token information, and webhook subscriptions
    through a unified REST API.
  version: 1.0.0
  license:
    name: ''
  contact:
    name: Dune Support
    url: https://docs.sim.dune.com
    email: support@dune.com
servers:
  - url: https://api.sim.dune.com
security:
  - ApiKeyAuth: []
tags:
  - name: evm
    description: EVM-compatible blockchain endpoints.
  - name: svm
    description: Solana/SVM blockchain endpoints.
  - name: activity
    description: On-chain activity feed.
  - name: balances
    description: Token balances (EVM and SVM).
  - name: transactions
    description: Transaction history (EVM and SVM).
  - name: collectibles
    description: NFT and ERC721/ERC1155 holdings.
  - name: defi
    description: DeFi protocol positions.
  - name: supported-chains
    description: Supported blockchain networks.
  - name: token-info
    description: Token metadata and pricing.
  - name: token-holders
    description: Token holder distribution.
  - name: subscriptions
    description: >-
      Webhook subscription management for real-time on-chain event
      notifications.
paths:
  /beta/evm/subscriptions/webhooks/{webhookId}/addresses:
    put:
      tags:
        - evm
        - subscriptions
      summary: Replace webhook addresses
      description: >-
        Replaces the entire list of subscribed addresses for a webhook with a
        new list.
      operationId: replaceWebhookAddresses
      parameters:
        - name: webhookId
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: The unique identifier of the webhook.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ReplaceAddresses'
            example:
              addresses:
                - '0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045'
                - '0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C'
      responses:
        '200':
          description: Addresses replaced successfully. No response body.
        '400':
          description: Invalid webhook ID.
          content:
            text/plain:
              schema:
                type: string
              example: >-
                Invalid URL: UUID parsing failed: invalid group length in group
                4: expected 12, found 11
        '429':
          description: Rate Limit Exceeded - Too many requests.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GatewayErrorResponse'
              examples:
                rateLimitExceeded:
                  value:
                    error: >-
                      Too many requests. Please contact sales@dune.com to
                      increase your limit.
components:
  schemas:
    ReplaceAddresses:
      type: object
      required:
        - addresses
      properties:
        addresses:
          type: array
          items:
            type: string
            description: EVM address.
          description: >-
            New list of addresses to monitor. This replaces the existing list
            entirely.
    GatewayErrorResponse:
      type: object
      description: >-
        Error response from the API gateway. Returned for authentication,
        permissions, rate-limiting, and quota errors.
      properties:
        error:
          type: string
          description: Error message.
      required:
        - error
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-Sim-Api-Key
      description: >-
        API key for authentication. Obtain your key from the Dune dashboard at
        sim.dune.com.

````