---
title: "Register endpoint"
description: "Register a webhook endpoint. The signing secret is shown once."
section: "API reference"
url: https://dravo.dev/docs/api/webhooks/create
---
# Register endpoint

The signing secret is returned once at creation. Use it to verify the
`Dravo-Signature` header on every delivery.

#### `POST /v1/webhooks`

Register a webhook endpoint. The signing secret is shown once.

**Auth:** Dashboard JWT only

| Field | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `url` | body | string (URL) | yes | Endpoint that will receive events. |
| `events` | body | string[] | yes | post.published, post.failed, post.queued or connection.revoked (at least one). |

Request:

```json
{
  "url": "https://example.com/hook",
  "events": [
    "post.published",
    "post.failed"
  ]
}
```

Response `201`: Created (secret shown once).

```json
{
  "id": "wh_1",
  "url": "https://example.com/hook",
  "events": [
    "post.published",
    "post.failed"
  ],
  "signing_secret": "whsec_…"
}
```