---
title: "Deactivate a webhook"
method: DELETE
path: "/v1/webhooks/{id}"
tags: ["Webhooks"]
---

# Deactivate a webhook

`DELETE /v1/webhooks/{id}`

Deactivates a webhook by ID.

## Path parameters

- `id` string, required

## Response `200`

Successful response

- union
  - EVMAddressActivityResponse
    - `id` string, required
    - `url` string, required
    - `chainId` string, required
    - `status` 'active' | 'inactive', required
    - `createdAt` number, required
    - `name` string, required
    - `description` string, required
    - `eventType` 'address_activity', required
    - `metadata` AddressActivityMetadata, required
      - `eventSignatures` string[] — Array of hexadecimal strings of the event signatures.
      - `addresses` string[], required — Ethereum address(es) for the address_activity event type. The maximum number of 'addresses' you can track depends on the Data API plan you are subscribed to.
    - `includeInternalTxs` boolean — Whether to include traces in the webhook payload.
    - `includeLogs` boolean — Whether to include logs in the webhook payload.
  - PrimaryNetworkAddressActivityResponse
    - `id` string, required
    - `url` string, required
    - `chainId` string, required
    - `status` 'active' | 'inactive', required
    - `createdAt` number, required
    - `name` string, required
    - `description` string, required
    - `eventType` 'primary_network_address_activity', required
    - `metadata` PrimaryNetworkAddressActivityMetadata, required
      - `eventSignatures` string[] — Array of hexadecimal strings of the event signatures.
      - `keyType` 'addresses', required — The type of key to monitor for the address activity event type.
      - `keys` string[], required — Array of keys like addresses corresponding to the keyType being monitored. For PrimaryNetworkAddressActivity event, an array of multiple addresses can be provided. The maximum number of 'addresses' you can track depends on the Data API plan you are subscribed to.
      - `subEvents` PrimaryNetworkAddressActivitySubEvents, required
        - `addressActivitySubEvents` PrimaryNetworkAddressActivitySubEventType[], required
      - `balanceThresholdFilter` PrimaryNetworkBalanceThresholdFilter
        - `balanceType` 'unlockedUnstaked' | 'unlockedStaked' | 'lockedPlatform' | 'lockedStakeable' | 'lockedStaked' | 'pendingStaked' | 'unlocked' | 'locked' | 'atomicMemoryUnlocked' | 'atomicMemoryLocked', required — Type of balance to monitor
        - `balanceThreshold` string, required — Threshold for balance corresponding to balanceType in nAVAX
  - ValidatorActivityResponse
    - `id` string, required
    - `url` string, required
    - `chainId` string, required
    - `status` 'active' | 'inactive', required
    - `createdAt` number, required
    - `name` string, required
    - `description` string, required
    - `eventType` 'validator_activity', required
    - `metadata` ValidatorActivityMetadata, required
      - `eventSignatures` string[] — Array of hexadecimal strings of the event signatures.
      - `keyType` 'nodeId' | 'subnetId', required — The type of key to monitor for the validator activity event type.
      - `keys` string[], required — Array of keys like NodeID or SubnetID corresponding to the keyType being monitored. ValidatorActivity event will only accept a single key
      - `subEvents` ValidatorActivitySubEvents, required
        - `validatorActivitySubEvents` string[], required — Array of validator activity sub-event types
      - `nodeIds` string[] — Array of node IDs to filter the events
      - `subnetIds` string[] — Array of subnet IDs to filter the events
      - `l1ValidatorFeeBalanceThreshold` string — L1 validator fee balance threshold in nAVAX

## Other responses

- `400` — Bad requests generally mean the client has passed invalid or malformed parameters. Error messages in the response could help in evaluating the error.
- `401` — When a client attempts to access resources that require authorization credentials but the client lacks proper authentication in the request, the server responds with 401.
- `403` — When a client attempts to access resources with valid credentials but doesn't have the privilege to perform that action, the server responds with 403.
- `404` — The error is mostly returned when the client requests with either mistyped URL, or the passed resource is moved or deleted, or the resource doesn't exist.
- `429` — This error is returned when the client has sent too many, and has hit the rate limit.
- `500` — The error is a generic server side error that is returned for any uncaught and unexpected issues on the server side. This should be very rare, and you may reach out to us if the problem persists for a longer duration.
- `502` — This is an internal error indicating invalid response received by the client-facing proxy or gateway from the upstream server.
- `503` — The error is returned for certain routes on a particular Subnet. This indicates an internal problem with our Subnet node, and may not necessarily mean the Subnet is down or affected.

---

[API](https://skmtc.net/avax/apis/data-api.md) · [All operations](https://skmtc.net/avax/apis/data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/avax/data-api/versions/745a94fa47f5/schema)