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

# Update a webhook endpoint (platform)



## OpenAPI

````yaml /en/openapi.json patch /v1/webhook_endpoints/{id}
openapi: 3.1.0
info:
  title: SimplePay API
  version: '2026-06-13'
  description: >-
    Contrato público para integrar SimplePay desde un backend. Incluye
    únicamente operaciones para comercios y administración protegida de
    credenciales.
servers:
  - description: Live
    url: https://api.simplepay.mx
  - description: Sandbox
    url: https://api.test.simplepay.mx
security:
  - SimplePayApiKey: []
tags:
  - name: API keys
  - name: Hosted Checkout
  - name: Payment Links
  - name: Payments
  - name: Refunds
  - name: Webhooks
  - name: Digital Catalog
  - name: Payment Policy
  - name: Reporting
  - name: Workspace
  - name: Customer Hub
  - name: Bookable Payments
  - name: Table Pay
  - name: Physical Checkout
  - name: In-person Payments
  - name: Terminal
  - name: Tap to Pay
  - name: Ticketing
  - name: Admission Control
  - name: Intelligence
externalDocs:
  description: SimplePay developer documentation
  url: https://docs.simplepay.mx
paths:
  /v1/webhook_endpoints/{id}:
    patch:
      tags:
        - Webhooks
      summary: Update a webhook endpoint (platform)
      operationId: updateWebhookEndpoint
      parameters:
        - $ref: '#/components/parameters/StepUpToken'
        - $ref: '#/components/parameters/IdempotencyKey'
        - name: id
          in: path
          required: true
          schema:
            type: string
            pattern: ^spwe_[a-z0-9]{32}$
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              minProperties: 1
              properties:
                description:
                  type:
                    - string
                    - 'null'
                  minLength: 1
                  maxLength: 500
                enabled_events:
                  type: array
                  minItems: 1
                  maxItems: 64
                  uniqueItems: true
                  items:
                    type: string
                    enum:
                      - '*'
                      - account.capability.updated
                      - account.requirements.updated
                      - balance.available
                      - checkout.completed
                      - checkout.created
                      - checkout.expired
                      - dispute.closed
                      - dispute.created
                      - dispute.updated
                      - payment.canceled
                      - payment.created
                      - payment.failed
                      - payment.processing
                      - payment.succeeded
                      - payment_link.completed
                      - payment_link.created
                      - payment_link.deactivated
                      - payment_link.updated
                      - payout.canceled
                      - payout.created
                      - payout.failed
                      - payout.paid
                      - payout.updated
                      - refund.created
                      - refund.failed
                      - refund.succeeded
                      - refund.updated
                status:
                  type: string
                  enum:
                    - active
                    - disabled
                url:
                  type: string
                  format: uri
                  maxLength: 2048
                  pattern: ^https://
      responses:
        2XX:
          description: Forwarded to the owning origin Worker.
components:
  parameters:
    StepUpToken:
      name: x-sp-step-up-token
      in: header
      required: true
      description: >-
        Short-lived, single-use SimplePay recent-auth proof bound to this
        mutation and Idempotency-Key.
      schema:
        type: string
        minLength: 32
        maxLength: 4096
    IdempotencyKey:
      name: Idempotency-Key
      in: header
      required: true
      schema:
        type: string
        minLength: 8
        maxLength: 255
  securitySchemes:
    SimplePayApiKey:
      type: http
      scheme: bearer

````