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

# Update Addresses

> Add or remove addresses from a webhook subscription.

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.

<Note>
  If you need to replace the entire address list at once, use the [Replace Webhook Addresses](/evm/subscriptions/replace-webhook-addresses) endpoint instead.
</Note>

## Example Use Cases

### Add New Addresses

Add one or more addresses to your existing subscription:

```json theme={null}
{
  "add_addresses": [
    "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
    "0x1234567890123456789012345678901234567890"
  ]
}
```

### Remove Addresses

Remove addresses that you no longer want to monitor:

```json theme={null}
{
  "remove_addresses": [
    "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C"
  ]
}
```

### Add and Remove in One Request

<Tip>
  You can add and remove addresses in the same request. The removal happens first, followed by the additions.
</Tip>

```json theme={null}
{
  "add_addresses": [
    "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb"
  ],
  "remove_addresses": [
    "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C"
  ]
}
```

<Note>
  This endpoint only manages addresses. To update other webhook properties like name, URL, or status, use the [Update Webhook](/evm/subscriptions/update-webhook) endpoint.
</Note>


## OpenAPI

````yaml /openapi.json PATCH /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:
    patch:
      tags:
        - evm
        - subscriptions
      summary: Update webhook addresses
      description: >-
        Add or remove individual addresses from a webhook subscription without
        replacing the entire list.
      operationId: updateWebhookAddresses
      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/UpdateAddresses'
            examples:
              add_addresses:
                summary: Add addresses
                value:
                  add_addresses:
                    - '0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb'
                    - '0x1234567890123456789012345678901234567890'
              remove_addresses:
                summary: Remove addresses
                value:
                  remove_addresses:
                    - '0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C'
              combined:
                summary: Add and remove in one request
                value:
                  add_addresses:
                    - '0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb'
                  remove_addresses:
                    - '0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C'
      responses:
        '200':
          description: Addresses updated 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:
    UpdateAddresses:
      type: object
      properties:
        add_addresses:
          type: array
          items:
            type: string
            description: EVM address.
          description: Addresses to add to the subscription list.
        remove_addresses:
          type: array
          items:
            type: string
            description: EVM address.
          description: Addresses to remove from the subscription list.
    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.

````