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

# Create Webhook Endpoint

> Register a webhook endpoint with a delivery URL and subscribed event types

Webhook endpoints let your platform receive event notifications from Hop over HTTPS. Webhook endpoints are customer-level resources, addressed under the owning customer (`/customers/{customer_id}/webhook-endpoints`) — consistent with accounts and agreements. You register an endpoint with a delivery URL and a filter of event types; Hop signs every delivery with the endpoint's signing secret.

Webhook endpoints are addressed by an id with the `wh_` prefix.

Registers a webhook endpoint with a delivery URL and a list of subscribed event types.

## Path Parameters

<ParamField path="customer_id" type="string" required>
  Id of the owning customer (`cus_…`).
</ParamField>

## Request Body

<ParamField body="url" type="string (HttpUrl)" required>
  HTTPS URL that will receive event deliveries.
</ParamField>

<ParamField body="events" type="string[]" required>
  Event types to subscribe to. At least one entry; each value is validated against the [subscribable event catalog](/va/webhooks/events).
</ParamField>

<ParamField body="description" type="string | null">
  Free-text label for the endpoint. Maximum 255 characters.
</ParamField>

## Response

Returns 200 with the new endpoint's `id` and its signing secret.

<ResponseField name="id" type="string">
  Id of the endpoint (`wh_…`).
</ResponseField>

<ResponseField name="secret" type="string">
  Signing secret used to verify webhook deliveries.
</ResponseField>

<Warning>
  Store the secret now. The full secret is returned only on create — it cannot be retrieved again later.
</Warning>

<RequestExample>
  ```json Request theme={null}
  {
    "url": "https://platform.example/hooks/inbound",
    "events": ["account.created", "virtual_account.updated", "payment.completed"],
    "description": "prod"
  }
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "id": "wh_3f8a2b1c9d4ex0y1z2a3b4c5",
    "secret": "9f2a7c1e6a2b4f3c9b8d2e5a1c7f9d04a1b2c3d4e5f60718293a4b5c6d7e8f90"
  }
  ```
</ResponseExample>