Kinde Management API — Webhooks

naftiko: 1.0.0-alpha2
info:
  label: Kinde Management API — Webhooks
  description: 'Kinde Management API — Webhooks. Manages outbound webhooks that notify external services
    when Kinde resources change (users, organizations, feature flags, roles, permissions, etc.):
    list/create/update/delete webhook endpoints and configure event subscriptions. Self-contained
    Naftiko capability covering one Kinde business surface.'
  tags:
  - Kinde
  - Webhooks
  - Events
  created: '2026-05-22'
  modified: '2026-05-22'
binds:
- namespace: env
  keys:
    KINDE_SUBDOMAIN: KINDE_SUBDOMAIN
    KINDE_ACCESS_TOKEN: KINDE_ACCESS_TOKEN
capability:
  consumes:
  - type: http
    namespace: kinde-webhooks
    baseUri: https://{KINDE_SUBDOMAIN}.kinde.com/api/v1
    description: Kinde Management API — Webhooks business capability. Self-contained, no shared references.
    resources:
    - name: webhooks
      path: /webhooks
      operations:
      - name: getWebhooks
        method: GET
        description: List all webhook endpoints in the environment.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters: []
      - name: createWebhook
        method: POST
        description: Register a new webhook endpoint with a list of event types.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          required: true
      - name: updateWebhook
        method: PATCH
        description: Update an existing webhook endpoint configuration.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          required: true
    - name: webhook
      path: /webhooks/{webhook_id}
      operations:
      - name: deleteWebhook
        method: DELETE
        description: Delete a webhook endpoint.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: webhook_id
          in: path
          type: string
          required: true