---
title: "Send notifications to Slack or a webhook"
method: POST
path: "/hooks"
tags: ["hook"]
---

# Send notifications to Slack or a webhook

`POST /hooks`

## Request

- Base URL: `https://localhost:4410/api/v1`
- URL: `https://localhost:4410/api/v1/hooks`
- Auth: HTTP bearer

Posts what the bell shows (who opened a link, who signed, what was asked) to a Slack incoming webhook or to a URL, with a link back to Binderwork and no document's content. A webhook's signing secret is shown once.

## Request body

- object
  - `kind` 'slack' | 'webhook', required
  - `url` string, required

## Response `200`

The result.

- object
  - `id` string, required
  - `kind` 'slack' | 'webhook', required
  - `label` string, required
  - `created_at` string, date-time, required
  - `last_delivered_at` string, date-time, nullable, required
  - `last_error` string, nullable, required
  - `secret` string, nullable, required

## Other responses

- `202`: Called by an agent or an API key, so the call did not run. A person approves it at approval_url; then GET the Location.
- `default`: An RFC 9457 problem.

---

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