Mews Connector API — Webhooks (API Events)

naftiko: 1.0.0-alpha2
info:
  label: Mews Connector API — Webhooks (API Events)
  description: Self-contained Naftiko capability for Mews Connector API Events / webhook registration and
    delivery. Mews pushes notifications for reservation, customer, bill, payment, and resource changes to
    the partner's HTTPS endpoint.
  tags:
  - Mews
  - Hospitality
  - Webhooks
  - Events
  created: '2026-05-25'
  modified: '2026-05-25'
binds:
- namespace: env
  keys:
    MEWS_CLIENT_TOKEN: MEWS_CLIENT_TOKEN
    MEWS_ACCESS_TOKEN: MEWS_ACCESS_TOKEN
    MEWS_CLIENT: MEWS_CLIENT
capability:
  consumes:
  - type: http
    namespace: connector-webhooks
    baseUri: https://api.mews.com
    description: Mews Connector — webhook registration and event polling.
    resources:
    - name: webhooks
      path: /api/connector/v1/webhooks
      operations:
      - name: register
        method: POST
        description: Register a webhook callback URL for one or more event types (registration is normally done out-of-band by Mews partner success, but the operation is documented under API Events).
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          required: true
    - name: events
      path: /api/connector/v1/events
      operations:
      - name: getAll
        method: POST
        description: Poll for events when push delivery is not feasible (fallback).
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          required: true
    authentication:
      type: body
      description: Mews Connector body-token authentication.
      keys:
        ClientToken: '{{env.MEWS_CLIENT_TOKEN}}'
        AccessToken: '{{env.MEWS_ACCESS_TOKEN}}'
        Client: '{{env.MEWS_CLIENT}}'
  exposes:
  - type: webhook
    namespace: connector-webhooks-receiver
    port: 8081
    description: Webhook receiver exposed for partners to accept Mews API Event push notifications. Mews posts JSON envelopes with Events[] arrays describing the change type and affected entity ids.
    events:
    - name: reservation-updated
      description: Reservation created, modified, state-changed, or cancelled.
      payload:
        type: object
    - name: customer-updated
      description: Customer profile created or modified.
      payload:
        type: object
    - name: bill-closed
      description: Bill closed and ready for posting.
      payload:
        type: object
    - name: payment-recorded
      description: Payment recorded against a bill or account.
      payload:
        type: object
    - name: resource-changed
      description: Resource (room/space) attributes or state changed.
      payload:
        type: object