---
title: "Create Webhook"
method: POST
path: "/api/v1/hooks"
tags: ["Webhooks"]
---

# Create Webhook

`POST /api/v1/hooks`

Register a callback URL that we will post document events to. Note: a `document_signed` event is not emitted solely because a pre-signed template signature/initials was copied as document content, and `event.related_signer` only identifies a real recipient signing action.

## Request body

- object
  - `callback_url` string, url, required — URL that we will post document events to.
  - `api_application_id` string, uuid — Unique identifier for the API Application.

## Response `201`

created

- WebhookResponse — Webhook subscription
  - `id` string, uuid, required
  - `callback_url` string, url, required
  - `api_application_id` string, uuid, nullable

## Other responses

- `400` — bad request
- `429` — rate limit exceeded

---

[API](https://skmtc.net/signwell/apis/signwell-developer-api.md) · [All operations](https://skmtc.net/signwell/apis/signwell-developer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/signwell/signwell-developer-api/revisions/debef5796b62/schema)