---
title: "Where inbound messages are delivered for this key; the signing secret is shown once"
method: PUT
path: "/v1/app/keys/{id}/webhook"
---

# Where inbound messages are delivered for this key; the signing secret is shown once

`PUT /v1/app/keys/{id}/webhook`

## Request

- Base URL: `https://api.octapi.app`
- URL: `https://api.octapi.app/v1/app/keys/{id}/webhook`
- Auth: HTTP bearer

## Path parameters

- `id` string, uuid, required

## Request body

- object
  - `url` string, starts_with, nullable, required
  - `events` string[]

## Response `200`

Default Response

- object
  - `secret` string, nullable, required

---

[API](https://skmtc.dev/octapi/apis/octapi-api.md) · [All operations](https://skmtc.dev/octapi/apis/octapi-api/llms.txt) · [OpenAPI document](https://skmtc.dev/octapi/apis/octapi-api/revisions/580afda787d2?raw)