---
title: "Create webhook"
method: POST
path: "/subscribe/"
tags: ["webhook"]
---

# Create webhook

`POST /subscribe/`

## Request

- Base URL: `https://eu-api.legalesign.com/api/v1`
- URL: `https://eu-api.legalesign.com/api/v1/subscribe/`
- Auth: API key in header `Authorization`

## Request body

- CallbackCreatePost
  - `url` string, required: The URL where you wish to get notified
  - `notify` string, required: The type of callback to receive, value must be all, signed, sent, rejected or realtime
  - `eventFilter` '' | 'document.*' | 'document.created' | 'document.rejected' | 'document.finalPdfCreated' | 'recipient.*' | 'recipient.completed' | 'recipient.rejected' | 'recipient.emailOpened' | 'recipient.visiting' | 'recipient.bounced'
  - `group` string

## Response `201`

operation successful

## Other responses

- `400`: bad request

## Changes

- **2025-09-26** `2e8288936d2d`: 1 info
  - endpoint added
- **2025-09-23** `3bf301e758f2`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/legalesign/apis/legalesign-api/changes/subscribe/post.md)

---

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