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

# Make a webhook endpoint

`POST /v1/webhooks`

## Request

- Base URL: `https://api.taada.dev`
- URL: `https://api.taada.dev/v1/webhooks`
- Auth: HTTP bearer

Tada POSTs `{ id, type, created, data }` to it for each event, signed `Tada-Signature: t=<unix>,v1=<hex HMAC-SHA256 of "<t>.<body>">` with the secret returned here, once.

## Request body

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

## Response `201`

Default Response

- object

## Other responses

- `400`: Default Response
- `404`: Default Response
- `422`: Default Response

---

[API](https://skmtc.dev/taada/apis/tada.md) · [All operations](https://skmtc.dev/taada/apis/tada/llms.txt) · [OpenAPI document](https://skmtc.dev/taada/apis/tada/revisions/9079c5c8a580?raw)