---
title: "Activa o pausa un webhook"
method: PATCH
path: "/webhooks/{id}"
tags: ["Webhooks"]
---

# Activa o pausa un webhook

`PATCH /webhooks/{id}`

## Request

- Base URL: `https://contadeo.com/api`
- URL: `https://contadeo.com/api/webhooks/{id}`
- Auth: `bearerAuth` (a scheme the document does not define)

Gestionable por owner/admin (sesión de usuario) o por una API key con el rol `webhooks` (opt-in al crear la key; el rol default `emisor` no basta).

## Path parameters

- `id` string, uuid, required

## Request body

- object
  - `activo` boolean, required

## Response `200`

Actualizado

- Webhook
  - `id` string, uuid
  - `url` string, uri: HTTPS obligatorio; se revalida contra SSRF en cada entrega.
  - `eventos` string[]
  - `activo` boolean
  - `descripcion` string, nullable
  - `createdAt` string, date-time
  - `updatedAt` string, date-time

## Other responses

- `404`: No encontrado

## Changes

- **2026-10-19** `461bbb9a74ce`: 1 warning
  - added the new `comprobante.anulado` enum value to the `eventos/items/` response property for the response status `200`

[Operation history](https://skmtc.dev/contadeo/apis/api-de-contadeo/changes/webhooks/:id/patch.md)

---

[API](https://skmtc.dev/contadeo/apis/api-de-contadeo.md) · [All operations](https://skmtc.dev/contadeo/apis/api-de-contadeo/llms.txt) · [OpenAPI document](https://skmtc.dev/contadeo/apis/api-de-contadeo/revisions/461bbb9a74ce?raw)