---
title: "Create new Webhook subscription"
method: POST
path: "/webhook/"
tags: ["webhooks"]
---

# Create new Webhook subscription

`POST /webhook/`

The subscription will send events to the specified URL.

## Request body

- CreateWebhook
  - `events` WebhookSubscriptionEvent[], required — A list of events to subscribe to. Each event has an `object_type` and an `action` from values in the [event log](https://developer.close.com/api/resources/events/list-of-event-types). You can also use [Webhook Filters](https://developer.close.com/api/resources/webhooks/webhook-filters) while creating your subscription so that an event only fires to a Webhook when certain conditions are met.
    - `action` string, required
    - `extra_filter` object, nullable
    - `object_type` string, required
  - `url` string, required — Destination URL for the webhook subscription
  - `verify_ssl` boolean — Verify SSL certificate of destination webhook URL. Set to `false` to disable SSL certificate validation. We recommend using https to protect your data during delivery.

## Response `201`

Successful response

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `404` — Not found

---

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