---
title: "Subscribes to a webhook."
method: POST
path: "/webhooks/v1/subscribe"
tags: ["Webhooks"]
---

# Subscribes to a webhook.

`POST /webhooks/v1/subscribe`

Subscribes to a Lodgify webhook.

## Request body

- LodgifyApiWebhooksModelsV1SubscribeBindingModel
  - `target_url` string, nullable — The call-back URL Lodgify site will call when the event is triggered in the system. This has to be unique each time. If it is not unique, we will return a 409 HTTP status code.
  - `event` 'rate_change' | 'availability_change' | 'booking_new_any_status' | 'booking_new_status_booked' | 'booking_change' | 'booking_status_change_booked' | 'booking_status_change_tentative' | 'booking_status_change_open' | 'booking_status_change_declined' | 'guest_message_received'

## Response `201`

Created

- LodgifyApiWebhooksModelsV1SubscribeModel
  - `id` string, nullable — The unique Id associated with this Webhook. Store this on your side, you will need it later to unsubscribe.
  - `secret` string, nullable — The secret associated with this Webhooks. This is needed to verify signatures when receiving a webhook to make sure its coming from Lodgify. This value will only be returned after the creation of the webhook

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `409` — Conflict
- `500` — Server Error

---

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