---
title: "Register Webhook"
method: POST
path: "/api/v2/webhooks"
---

# Register Webhook

`POST /api/v2/webhooks`

This endpoint registers a webhook to be used within an integration. Registering a webhook must happen before verifying a webhook.

## Request body

- object
  - `webhook` object
    - `url` string — The URL where Hover will POST webhook events.
    - `content_type` string — Optional and defaults to `x-www-form-urlencoded`. When it's given a valid value, webhook will include specified content type in POST header. Currently supports `x-www-form-urlencoded` and `json`

## Response `200`

200

- object
  - `id` string
  - `owner_type` string
  - `owner_id` string
  - `url` string
  - `created_at` string
  - `updated_at` string
  - `verified_at` string
  - `hmac_secret` string
  - `last_error` string
  - `content_type` string

## Other responses

- `400` — 400
- `422` — Unprocessable Entity

---

[API](https://skmtc.net/hover/apis/hover-api-v3.md) · [All operations](https://skmtc.net/hover/apis/hover-api-v3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hover/hover-api-v3/versions/98ae3699d4c9/schema)