---
title: "PATCH /api/v3/webhooks/{webhook_id}"
method: PATCH
path: "/api/v3/webhooks/{webhook_id}"
tags: ["webhooks"]
---

# PATCH /api/v3/webhooks/{webhook_id}

`PATCH /api/v3/webhooks/{webhook_id}`

## Request

- Base URL: `https://delivery.99minutos.com`
- URL: `https://delivery.99minutos.com/api/v3/webhooks/{webhook_id}`
- Auth: HTTP bearer

Update webhook configuration. You can update headers or/and status_rules.

webhook notification example:

```json
{
  "headers": {
    "Content-Type": "application/json" // Change the headers
  },
  "status_rules": {
    "allowed_status_names": [
      "delivered"   // Change the allowed status names
    ]
  }
}
```

### Catálogo de estados predeterminados

Los siguientes 15 estados se incluyen por defecto al registrar un webhook.

Para actualizar la suscripción, envía los valores de `StatusName` en `status_rules.allowed_status_names`. La lista enviada reemplaza la lista configurada actualmente. `StatusCode` se incluye como referencia del evento notificado y se envía como string; `StatusName` utiliza camelCase.

| StatusCode | StatusName |
| --- | --- |
| `2002` | `onRoadToPickup` |
| `2003` | `collected` |
| `2101` | `unsuccessfulPickup` |
| `3001` | `stored` |
| `3004` | `onLinehaul` |
| `4001` | `onRoadToDelivery` |
| `4002` | `delivered` |
| `4101` | `unsuccessfulDelivery` |
| `5001` | `onRoadToReturn` |
| `5002` | `returned` |
| `5101` | `unsuccessfulReturn` |
| `8001` | `stolen` |
| `8002` | `lost` |
| `8003` | `cancelled` |
| `8005` | `invalidAddress` |

## Request body

- object
  - `headers` object: Mapa de hasta 3 encabezados personalizados. Un mapa no vacío reemplaza los encabezados configurados.
  - `status_rules` object: Configuración de los estados que generan notificaciones del webhook.
    - `allowed_status_names` string[]: Nombres de estado en camelCase. Una lista no vacía reemplaza los estados configurados. Consulta el catálogo de estados predeterminados de esta operación.

## Response `200`

Config Response

- object
  - `status` integer
  - `message` string
  - `data` object
    - `status_rules` object
      - `status_rules` integer
      - `allowed_status_names` string[]
    - `headers` object
      - `Authorization` string
      - `Content-Type` string
      - `User-Agent` string
    - `id` string
    - `owner` object
      - `client_id` string
    - `url` string

## Changes

- **2026-11-03** `d05ecf04ecbe`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/99minutos/apis/api-version-3/changes/api/v3/webhooks/:webhook_id/patch.md)

---

[API](https://skmtc.dev/99minutos/apis/api-version-3.md) - [All operations](https://skmtc.dev/99minutos/apis/api-version-3/llms.txt) - [OpenAPI document](https://skmtc.dev/99minutos/apis/api-version-3/revisions/d05ecf04ecbe?raw)