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

# Listar webhooks

> Lista los webhooks configurados en una cuenta, con filtro opcional por estado

Lista los webhooks configurados en una cuenta, con sus secretos enmascarados. Una cuenta sin webhooks devuelve un arreglo vacío.

Envía `state=ACTIVE` o `state=INACTIVE` para listar solo los webhooks en ese estado, y omítelo para listarlos todos.

Los mismos webhooks aparecen en la pestaña Developers del [dashboard de Yuno](https://docs.y.uno/es/docs/webhooks/configure-webhooks.md).


## OpenAPI

````yaml openapi/es/webhooks/manage-webhooks.json GET /webhooks
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:
    get:
      summary: Listar webhooks
      description: >-
        Devuelve los webhooks configurados en una cuenta, con sus secretos
        enmascarados. Filtra por `state` para listar solo los activos o los
        inactivos.
      operationId: list-webhooks
      parameters:
        - name: account_id
          in: query
          required: true
          description: >-
            El identificador único de la cuenta a la que pertenecen los
            webhooks.
          schema:
            type: string
            format: uuid
            example: 493e9374-510a-4201-9e09-de669d75f256
            x-default: 493e9374-510a-4201-9e09-de669d75f256
        - name: state
          in: query
          required: false
          description: >-
            Devuelve solo los webhooks en este estado. Omítelo para devolverlos
            todos.
          schema:
            type: string
            enum:
              - ACTIVE
              - INACTIVE
            example: ACTIVE
      responses:
        '200':
          description: >-
            Los webhooks configurados en la cuenta, o un arreglo vacío si no
            tiene ninguno.
          content:
            application/json:
              schema:
                type: array
                items:
                  $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: []
                  payment_triggers:
                    - AUTHORIZE
                    - CAPTURE
                    - REFUND
                  report_triggers: []
                  subscription_triggers: null
                  onboarding_triggers: null
                  renewal_days: null
                  created_at: '2026-07-09T13:05:36.482913Z'
                  updated_at: '2026-07-09T13:05:36.482913Z'
                - id: '12346'
                  account_id: 493e9374-510a-4201-9e09-de669d75f256
                  name: Subscription renewals
                  state: INACTIVE
                  url: https://api.acme.com/yuno/subscriptions
                  api_key: '***'
                  secret: '***'
                  hmac_client_secret: null
                  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: []
                  payment_triggers: []
                  report_triggers: []
                  subscription_triggers:
                    - CREATE
                    - CLOSE_TO_RENEWAL
                  onboarding_triggers: null
                  renewal_days: 5
                  created_at: '2026-07-10T09:41:12.204518Z'
                  updated_at: '2026-07-11T16:20:44.918330Z'
        '400':
          $ref: '#/components/responses/InvalidListRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '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
    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:
    InvalidListRequest:
      description: >-
        El `account_id` falta o no es válido, o `state` no es `ACTIVE` ni
        `INACTIVE`.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/WebhookRequestError'
          examples:
            Missing account_id:
              value:
                code: WEBHOOK_INVALID_REQUEST
                messages:
                  - account_id is required.
            Invalid state:
              value:
                code: WEBHOOK_INVALID_REQUEST
                messages:
                  - state must be ACTIVE or INACTIVE.
            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
    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.