---
title: "Create a new webhook subscription."
method: POST
path: "/v2/webhooksubscriptions"
tags: ["WebhookSubscriptions"]
---

# Create a new webhook subscription.

`POST /v2/webhooksubscriptions`

## Request body

- WebhookSubscriptionModel — An individual
  - `id` integer — The ID of this record.
  - `action` 'entity_create' | 'entity_update' | 'entity_delete' | 'application_authorization_revoked' | 'webhook_test' — The record action that triggers a webhook to be sent to a subscription.
  - `api_application_connection_id` integer — The ID of the API application connection which owns this subscription.
  - `category` string — The category of changes to send to this webhook URL when Type is Change. Null for all changes. (See /v2/webhooksubscriptions/categories for a list of possible values.)
  - `type` 'none' | 'booking' | 'guest' | 'property' | 'message' | 'quote' | 'inquiry' | 'surcharge' | 'discount'
  - `webhook_url` string, uri, required — The URL to which webhooks should be sent for this subscription.

## Response `200`

A model representing the webhook subscription created.

- WebhookSubscriptionModel — An individual
  - `id` integer — The ID of this record.
  - `action` 'entity_create' | 'entity_update' | 'entity_delete' | 'application_authorization_revoked' | 'webhook_test' — The record action that triggers a webhook to be sent to a subscription.
  - `api_application_connection_id` integer — The ID of the API application connection which owns this subscription.
  - `category` string — The category of changes to send to this webhook URL when Type is Change. Null for all changes. (See /v2/webhooksubscriptions/categories for a list of possible values.)
  - `type` 'none' | 'booking' | 'guest' | 'property' | 'message' | 'quote' | 'inquiry' | 'surcharge' | 'discount'
  - `webhook_url` string, uri, required — The URL to which webhooks should be sent for this subscription.

---

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