---
title: "Creează un webhook (notificare push la schimbare de verdict)"
method: POST
path: "/api/v1/webhooks"
tags: ["Monitorizare"]
---

# Creează un webhook (notificare push la schimbare de verdict)

`POST /api/v1/webhooks`

## Request

- Base URL: `https://firmoscop.ro`
- URL: `https://firmoscop.ro/api/v1/webhooks`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `fs_session`

Se declanșează la re-verificarea zilnică a firmelor din watchlist, când verdictul se schimbă. Livrare semnată HMAC (header X-Firmoscop-Signature: sha256=HMAC(`${timestamp}.${body}`)), cu retry exponențial și dead-letter. Secretul e afișat o singură dată.

## Request body

- object
  - `url` string, uri, required: URL public http(s).
  - `events` string[]: Implicit: verdict.changed.

## Response `201`

Webhook creat (secret afișat o singură dată).

- WebhookCreated
  - `id` integer
  - `url` string
  - `events` string[]
  - `secret` string: Secretul de semnare HMAC — afișat o singură dată.

## Other responses

- `400`: Eroare — corp JSON { error, message } în limbaj natural.
- `401`: Eroare — corp JSON { error, message } în limbaj natural.

---

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