---
search:
  tags:
    - Operations
    - POST
seo:
  description: >-
    The URL an external sender calls. Present the Webhook's secret as… Reference
    for the POST /api/v1/hooks/{webhookId} endpoint in the Charming API.
sidebar:
  label: Deliver an event to a Webhook
  badge: POST
title: Deliver an event to a Webhook
type: openapi-operation
---
The URL an external sender calls. Present the Webhook's secret as `Authorization: Bearer chrm_hook_…` or `?key=chrm_hook_…`. The JSON body is the target op's input, validated against its declared input schema; the response is the op's own result envelope, validated against its output schema. Tagged `x-charming-trigger: webhook` for the handler.

`POST /api/v1/hooks/{webhookId}`

Found a bug or need a feature? [Tell us](/docs/capabilities/feedback) with `submit_feedback` or `POST /app/{id}/feedback`. Your feedback shapes what we build next.