> ## Documentation Index
> Fetch the complete documentation index at: https://docs.y.uno/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Test in the sandbox first: base URL https://api-sandbox.y.uno (Test Mode in the Dashboard). Production is https://api.y.uno (Live Mode).
> Every API request needs the public-api-key and private-secret-key headers. Get them in the Dashboard at https://dashboard.y.uno/developers (Developers > Credentials); sandbox and production keys are different.
> Send an X-Idempotency-Key (a UUID) when creating payments, refunds and cancels, so retries do not create duplicates.
> Start with the Quickstart (https://docs.y.uno/docs/quickstart.md) and the agent guide (https://docs.y.uno/agents.md). To search these docs from a coding agent, connect the docs MCP server at https://docs.y.uno/mcp.

# Eliminar un webhook

> Elimina un webhook y detiene las notificaciones que Yuno envía a su URL

Elimina un webhook. Yuno deja de enviar notificaciones a su `url` y devuelve el webhook que eliminó, para que conserves un registro de los eventos a los que estaba suscrito.

Para detener las notificaciones y conservar la configuración, define `state` como `INACTIVE` con [Actualizar un webhook](https://docs.y.uno/es/reference/webhooks/update-webhook.md) en su lugar.


## OpenAPI

````yaml openapi/es/webhooks/manage-webhooks.json DELETE /webhooks/{webhook_id}
openapi: 3.1.0
info:
  title: webhooks-manage-webhooks
  version: 1.0.0
servers:
  - url: https://api-sandbox.y.uno/v1
    description: Sandbox
  - url: https://api.y.uno/v1
    description: Production (US)
security:
  - sec0: []
    sec1: []
paths:
  /webhooks/{webhook_id}:
    delete:
      summary: Eliminar un webhook
      description: >-
        Elimina un webhook. Yuno deja de enviar notificaciones a su URL y
        devuelve el webhook que eliminó.
      operationId: delete-webhook
      parameters:
        - name: webhook_id
          in: path
          required: true
          description: >-
            El identificador único del webhook, tal como lo devuelve [Listar
            webhooks](/es/reference/webhooks/list-webhooks).
          schema:
            type: string
            example: '12345'
        - name: account_id
          in: query
          required: true
          description: El identificador único de la cuenta a la que pertenece el webhook.
          schema:
            type: string
            format: uuid
            example: 493e9374-510a-4201-9e09-de669d75f256
            x-default: 493e9374-510a-4201-9e09-de669d75f256
      responses:
        '200':
          description: El webhook que eliminaste.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Webhook'
              example:
                id: '12345'
                account_id: 493e9374-510a-4201-9e09-de669d75f256
                name: Production payments listener
                state: ACTIVE
                url: https://api.acme.com/yuno/webhooks
                api_key: '***'
                secret: '***'
                hmac_client_secret: '***'
                oauth2_authentication_url: null
                oauth2_client_secret: null
                oauth2_client_id: null
                oauth2_grant_type: null
                oauth2_scope: null
                oauth2_authorization_name: null
                oauth2_include_client_id: false
                enrollment_triggers:
                  - ENROLL
                  - UNENROLL
                payment_triggers:
                  - AUTHORIZE
                  - CAPTURE
                  - REFUND
                report_triggers: []
                subscription_triggers:
                  - CREATE
                  - CLOSE_TO_RENEWAL
                onboarding_triggers: null
                renewal_days: 5
                created_at: '2026-07-09T13:05:36.482913Z'
                updated_at: '2026-07-09T13:05:36.482913Z'
        '400':
          $ref: '#/components/responses/InvalidAccountRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/WebhookNotFound'
        '502':
          $ref: '#/components/responses/UpstreamError'
components:
  schemas:
    Webhook:
      type: object
      properties:
        id:
          type: string
          description: El identificador único del webhook.
          example: '12345'
        account_id:
          type: string
          format: uuid
          description: El identificador único de la cuenta a la que pertenece el webhook.
          example: 493e9374-510a-4201-9e09-de669d75f256
        name:
          type: string
          description: Tu nombre para el webhook.
          example: Production payments listener
        state:
          type: string
          description: >-
            Los webhooks `ACTIVE` reciben notificaciones, los `INACTIVE` no. Un
            webhook empieza como `ACTIVE`.
          enum:
            - ACTIVE
            - INACTIVE
          example: ACTIVE
        url:
          type: string
          description: El endpoint al que Yuno envía las notificaciones.
          example: https://api.acme.com/yuno/webhooks
        api_key:
          type:
            - string
            - 'null'
          description: Enmascarado como `***`, o `null` cuando no lo has configurado.
          example: '***'
        secret:
          type:
            - string
            - 'null'
          description: Enmascarado como `***`, o `null` cuando no lo has configurado.
          example: '***'
        hmac_client_secret:
          type:
            - string
            - 'null'
          description: Enmascarado como `***`, o `null` cuando no lo has configurado.
          example: '***'
        oauth2_authentication_url:
          type:
            - string
            - 'null'
          description: Tu endpoint de token.
          example: https://api.acme.com/oauth/token
        oauth2_client_secret:
          type:
            - string
            - 'null'
          description: Enmascarado como `***`, o `null` cuando no lo has configurado.
          example: '***'
        oauth2_client_id:
          type:
            - string
            - 'null'
          description: El identificador de cliente con el que Yuno se autentica.
          example: acme_client_id
        oauth2_grant_type:
          type:
            - string
            - 'null'
          description: El tipo de concesión con el que Yuno solicita el token.
          example: client_credentials
        oauth2_scope:
          type:
            - string
            - 'null'
          description: El alcance con el que Yuno solicita el token.
          example: webhooks:write
        oauth2_authorization_name:
          type:
            - string
            - 'null'
          description: El encabezado en el que Yuno envía el token.
          example: Authorization
        oauth2_include_client_id:
          type: boolean
          description: >-
            Indica si Yuno también envía el identificador de cliente como
            encabezado en la solicitud del token.
          example: true
        enrollment_triggers:
          type:
            - array
            - 'null'
          description: Los eventos de inscripción a los que se suscribe el webhook.
          items:
            type: string
          example:
            - ENROLL
            - UNENROLL
        payment_triggers:
          type:
            - array
            - 'null'
          description: Los eventos de pago a los que se suscribe el webhook.
          items:
            type: string
          example:
            - AUTHORIZE
            - CAPTURE
            - REFUND
        report_triggers:
          type:
            - array
            - 'null'
          description: Los eventos de reportes a los que se suscribe el webhook.
          items:
            type: string
          example:
            - UPDATE
        subscription_triggers:
          type:
            - array
            - 'null'
          description: Los eventos de suscripción a los que se suscribe el webhook.
          items:
            type: string
          example:
            - CREATE
            - CLOSE_TO_RENEWAL
        onboarding_triggers:
          type:
            - array
            - 'null'
          description: Los eventos de onboarding a los que se suscribe el webhook.
          items:
            type: string
          example:
            - CREATED
            - SUCCEEDED
        renewal_days:
          type:
            - integer
            - 'null'
          description: >-
            Cuántos días antes de una renovación Yuno envía la notificación
            `CLOSE_TO_RENEWAL`.
          example: 5
        created_at:
          type: string
          description: La fecha y hora en que se creó el webhook, en ISO 8601.
          example: '2026-07-09T13:05:36.482913Z'
          format: date-time
        updated_at:
          type: string
          description: >-
            La fecha y hora de la última actualización del webhook, en ISO 8601.
            Coincide con `created_at` hasta que actualizas el webhook por
            primera vez.
          example: '2026-07-11T16:20:44.918330Z'
          format: date-time
    WebhookRequestError:
      type: object
      properties:
        code:
          type: string
          description: Código de error legible por máquina.
          enum:
            - WEBHOOK_INVALID_REQUEST
            - INVALID_ACCOUNT_ID
        messages:
          type: array
          description: Descripción legible del error.
          items:
            type: string
    WebhookAuthError:
      type: object
      properties:
        code:
          type: string
          description: Código de error legible por máquina.
          enum:
            - NOT_AUTHENTICATED
            - INVALID_CREDENTIALS
        messages:
          type: array
          description: Descripción legible del error.
          items:
            type: string
    WebhookNotFoundError:
      type: object
      properties:
        code:
          type: string
          description: Código de error legible por máquina.
          enum:
            - WEBHOOK_NOT_FOUND
        messages:
          type: array
          description: Descripción legible del error.
          items:
            type: string
    WebhookUpstreamError:
      type: object
      properties:
        code:
          type: string
          description: Código de error legible por máquina.
          enum:
            - WEBHOOK_UPSTREAM_ERROR
        messages:
          type: array
          description: Descripción legible del error.
          items:
            type: string
  responses:
    InvalidAccountRequest:
      description: El `account_id` falta o no es válido.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/WebhookRequestError'
          examples:
            Missing account_id:
              value:
                code: WEBHOOK_INVALID_REQUEST
                messages:
                  - account_id is required.
            Invalid account_id:
              value:
                code: INVALID_ACCOUNT_ID
                messages:
                  - Account id is invalid
    Unauthorized:
      description: Tus credenciales de API faltan o no son válidas.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/WebhookAuthError'
          examples:
            Not authenticated:
              value:
                code: NOT_AUTHENTICATED
                messages:
                  - Not authenticated
            Invalid credentials:
              value:
                code: INVALID_CREDENTIALS
                messages:
                  - Invalid Credentials
    WebhookNotFound:
      description: No hay ningún webhook con ese identificador en la cuenta.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/WebhookNotFoundError'
          examples:
            Not found:
              value:
                code: WEBHOOK_NOT_FOUND
                messages:
                  - The webhook does not exist for this account.
    UpstreamError:
      description: El servicio de webhooks no está disponible temporalmente.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/WebhookUpstreamError'
          examples:
            Service unavailable:
              value:
                code: WEBHOOK_UPSTREAM_ERROR
                messages:
                  - The webhook service is temporarily unavailable.
  securitySchemes:
    sec0:
      type: apiKey
      in: header
      name: public-api-key
      x-default: <Your public-api-key>
    sec1:
      type: apiKey
      in: header
      name: private-secret-key
      x-default: <Your private-secret-key>

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.