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

# Update Webhook Endpoint

> Change a webhook URL, subscriptions, name, or delivery status.

Send only the fields you want to change. When supplied, `event_types` replaces
the entire subscription list.

Set `status` to `PAUSED` to stop creating deliveries for new events. Set it to
`ACTIVE` to resume delivery and clear the consecutive-failure counter.

<Note>
  Events generated while an endpoint is paused are not backfilled when it is
  reactivated.
</Note>


## OpenAPI

````yaml reference/openapi.json PATCH /webhooks/endpoints/{endpoint_id}
openapi: 3.0.0
info:
  title: Unifystays API
  description: >-
    One unified hotel API across suppliers. Integrate once, then enable and
    manage suppliers from the Unifystays portal.
  version: '1.0'
  contact: {}
servers:
  - url: https://api-sandbox.unifystays.com
    description: Sandbox
  - url: https://api.unifystays.com
    description: Production
security:
  - x-api-key: []
tags: []
paths:
  /webhooks/endpoints/{endpoint_id}:
    patch:
      tags:
        - Webhooks
      summary: Update or pause a webhook endpoint
      description: >-
        Updates any supplied fields. event_types replaces the complete
        subscription list.
      operationId: WebhookController_updateEndpoint
      parameters:
        - name: endpoint_id
          required: true
          in: path
          description: Webhook endpoint UUID.
          schema:
            example: 8b95a9e0-4af3-4c6d-92df-84b64256d27f
            type: string
        - name: language
          description: Enter language code(ex. en)
          in: header
          schema: {}
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateWebhookEndpointDto'
      responses:
        '200':
          description: Webhook endpoint updated successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WebhookEndpointResponseDto'
components:
  schemas:
    UpdateWebhookEndpointDto:
      type: object
      properties:
        name:
          type: string
          description: New human-readable endpoint name.
          example: Production booking events
          minLength: 1
          maxLength: 120
        url:
          type: string
          description: New public HTTPS delivery URL.
          example: https://example.com/webhooks/unifystays
          minLength: 8
          maxLength: 2048
        event_types:
          type: array
          description: Replacement event subscriptions. Send the complete desired list.
          example:
            - booking.*
          minItems: 1
          maxItems: 20
          items:
            type: string
            enum:
              - booking.created
              - booking.confirmed
              - booking.failed
              - booking.cancellation_requested
              - booking.cancelled
              - booking.cancellation_failed
              - booking.*
        status:
          type: string
          description: Activate or pause delivery to this endpoint.
          enum:
            - ACTIVE
            - PAUSED
          example: ACTIVE
    WebhookEndpointResponseDto:
      type: object
      properties:
        id:
          type: string
          format: uuid
          example: 8b95a9e0-4af3-4c6d-92df-84b64256d27f
          description: Unique webhook endpoint identifier.
        name:
          type: string
          example: Production booking events
          description: Human-readable endpoint name.
        url:
          type: string
          format: uri
          example: https://example.com/webhooks/unifystays
          description: URL that receives signed webhook POST requests.
        status:
          type: string
          enum:
            - ACTIVE
            - PAUSED
            - DISABLED
          example: ACTIVE
          description: >-
            Current endpoint state. Paused and disabled endpoints do not receive
            new deliveries.
        event_types:
          type: array
          example:
            - booking.confirmed
            - booking.cancelled
          description: Normalized event subscriptions for this endpoint.
          items:
            type: string
            enum:
              - booking.created
              - booking.confirmed
              - booking.failed
              - booking.cancellation_requested
              - booking.cancelled
              - booking.cancellation_failed
              - booking.*
        consecutive_failures:
          type: number
          example: 0
          description: >-
            Consecutive delivery failures since the last success or
            reactivation.
        last_success_at:
          type: string
          format: date-time
          nullable: true
          example: '2026-08-08T08:30:00.000Z'
          description: Time of the most recent successful delivery, if any.
        last_failure_at:
          type: string
          format: date-time
          nullable: true
          example: null
          description: Time of the most recent failed delivery, if any.
        disabled_at:
          type: string
          format: date-time
          nullable: true
          example: null
          description: Time the endpoint was disabled, if applicable.
        disabled_reason:
          type: string
          nullable: true
          example: null
          description: Reason the endpoint was disabled, if applicable.
        created_at:
          type: string
          format: date-time
          example: '2026-08-08T08:00:00.000Z'
          description: Endpoint creation time.
        updated_at:
          type: string
          format: date-time
          example: '2026-08-08T08:30:00.000Z'
          description: Time the endpoint was last updated.
      required:
        - id
        - name
        - url
        - status
        - event_types
        - consecutive_failures
        - last_success_at
        - last_failure_at
        - disabled_at
        - disabled_reason
        - created_at
        - updated_at
  securitySchemes:
    x-api-key:
      type: apiKey
      in: header
      name: x-api-key
      description: Environment-specific API key created in the Unifystays portal

````