---
title: "Create a signed webhook endpoint"
method: POST
path: "/v1/webhooks"
tags: ["Webhooks"]
---

# Create a signed webhook endpoint

`POST /v1/webhooks`

## Request

- Base URL: `https://api.ironfang.com/audit`
- URL: `https://api.ironfang.com/audit/v1/webhooks`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Registers an event delivery endpoint for the authenticated organisation and returns its new signing secret. Store the secret when creating the endpoint; subsequent listings do not disclose it.

## Request body

- object
  - `events` string[]
  - `url` string, uri, required

## Response `201`

Endpoint and one-time signing secret

## Other responses

- `400`: Problem response
- `401`: Problem response
- `403`: Problem response
- `422`: Problem response

---

[API](https://skmtc.dev/ironfang/apis/ironfang-audit-api.md) · [All operations](https://skmtc.dev/ironfang/apis/ironfang-audit-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ironfang/apis/ironfang-audit-api/revisions/7430deff2cbd?raw)