> For the complete documentation index, see [llms.txt](https://mobile-calendar.gitbook.io/v1/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mobile-calendar.gitbook.io/v1/webhooks/webhook-events.md).

# Webhook events

## Overview

This document provides a complete reference for all **Mobile Calendar Webhook Events**.\
Each event includes its description and a sample JSON payload. Webhooks deliver only the essential data — for full details, follow the `links.self` URL to fetch the full entity from the API.

***

## Reservation Events

### reservation.created

Triggered when a new reservation is created.

{% code title="reservation.created (sample payload)" %}

```json
{
  "webhookId": "9b9b499e-095c-4955-8dd0-cc5d84e50764",
  "eventType": "reservation.created",
  "timestamp": "2025-10-10T15:39:07+02:00",
  "data": {
    "type": "SINGLE",
    "reservationId": 478652,
    "roomId": 28568,
    "arrival": "2025-10-14",
    "departure": "2025-10-16",
    "clientId": 362792,
    "triggeredBy": "MANUAL",
    "sourceId": 0,
    "links": {
      "self": "https://apisandbox.mobile-calendar.com/v1/reservations/478652"
    }
  }
}
```

{% endcode %}

{% code title="reservation.created (sample payload - GROUP RESERVATION)" %}

```json
{
  "webhookId": "9b9b499e-095c-4955-8dd0-cc5d84e50764",
  "eventType": "reservation.created",
  "timestamp": "2025-10-10T15:39:07+02:00",
  "data": {
    "type": "GROUP",
    "reservationId": [478652, 478653],
    "roomId": [28568, 28569],
    "arrival": "2025-10-14",
    "departure": "2025-10-16",
    "clientId": 362792,
    "triggeredBy": "MANUAL",
    "sourceId": 0,
    "links": {
      "self": "https://apisandbox.mobile-calendar.com/v1/reservations/478652"
    }
  }
}
```

{% endcode %}

{% hint style="warning" %}
When `type = GROUP`, the fields `reservationId` and `roomId` are arrays instead of single integer values.

Use the provided `links.self` to fetch the full reservation data.
{% endhint %}

### reservation.updated

Triggered when reservation details are changed.

{% code title="reservation.updated (sample payload)" %}

```json
{
  "webhookId": "a61f7f81-abc1-42b9-bf13-cf894ccbf93b",
  "eventType": "reservation.updated",
  "timestamp": "2025-10-10T15:42:11+02:00",
  "data": {
    "reservationId": 478652,
    "roomId": 28568,
    "clientId": 362792,
    "arrival": "2025-10-14",
    "departure": "2025-10-16",
    "changedFields": ["arrival", "departure", "price"],
    "triggeredBy": "API",
    "links": {
      "self": "https://apisandbox.mobile-calendar.com/v1/reservations/478652"
    }
  }
}
```

{% endcode %}

### reservation.deleted

Triggered when a reservation is deleted.

{% code title="reservation.deleted (sample payload)" %}

```json
{
  "webhookId": "b9c1993a-8f3c-4673-9009-993b454d2dbf",
  "eventType": "reservation.deleted",
  "timestamp": "2025-10-10T15:50:44+02:00",
  "data": {
    "reservationId": 478652,
    "roomId": 28568,
    "clientId": 362792,
    "arrival": "2025-10-14",
    "departure": "2025-10-16",
    "triggeredBy": "CHANNEL_MANAGER",
    "links": {
      "self": "https://apisandbox.mobile-calendar.com/v1/reservations/478652?"
    }
  }
}
```

{% endcode %}

### reservation.restored

Triggered when a deleted reservation is restored.

{% code title="reservation.restored (sample payload)" %}

```json
{
  "webhookId": "ffb3e116-9d66-48d9-a0a5-24f35457d9f1",
  "eventType": "reservation.restored",
  "timestamp": "2025-10-10T15:58:22+02:00",
  "data": {
    "reservationId": 478652,
    "roomId": 28568,
    "clientId": 362792,
    "arrival": "2025-10-14",
    "departure": "2025-10-16",
    "triggeredBy": "API",
    "links": {
      "self": "https://apisandbox.mobile-calendar.com/v1/reservations/478652"
    }
  }
}
```

{% endcode %}

***

## Lock Events

### lock.created

Triggered when a new lock device is created.

{% code title="lock.created (sample payload)" %}

```json
{
  "webhookId": "33a9a742-30c2-4c6a-935e-32b3f77f6f13",
  "eventType": "lock.created",
  "timestamp": "2025-10-10T16:02:00+02:00",
  "data": {
    "type": "LOCK",
    "lockId": 1205,
    "roomId": 28568,
    "from": "2024-01-01",
    "to": "2024-01-05",
    "createdBy": "API",
    "links": {
      "self": "https://apisandbox.mobile-calendar.com/v1/reservations/1205"
    }
  }
}
```

{% endcode %}

### lock.updated

Triggered when lock data changes.

{% code title="lock.updated (sample payload)" %}

```json
{
  "webhookId": "29b7c7ab-1df8-48d3-928a-38215df2b773",
  "eventType": "lock.updated",
  "timestamp": "2025-10-10T16:03:22+02:00",
  "data": {
    "type": "LOCK",
    "lockId": 1205,
    "roomId": 28568,
    "from": "2024-01-01",
    "to": "2024-01-05",
    "changedFields": ["additionalInfo"],
    "triggeredBy": "MANUAL",
    "links": {
      "self": "https://apisandbox.mobile-calendar.com/v1/reservations/1205"
    }
  }
}
```

{% endcode %}

### lock.deleted

Triggered when a lock is deleted.

{% code title="lock.deleted (sample payload)" %}

```json
{
  "webhookId": "5b48a012-b48c-43aa-a9db-9b9c672c9f83",
  "eventType": "lock.deleted",
  "timestamp": "2025-10-10T16:10:18+02:00",
  "data": {
    "type": "LOCK",
    "lockId": 1205,
    "roomId": 28568,
    "from": "2024-01-01",
    "to": "2024-01-05",
    "triggeredBy": "MANUAL",
    "links": {
      "self": "https://apisandbox.mobile-calendar.com/v1/reservations/1205"
    }
  }
}
```

{% endcode %}

***

## Client Events

### client.created

Triggered when a new client is created.

{% code title="client.created (sample payload)" %}

```json
{
  "webhookId": "92dc5ee2-6e43-44ad-b69e-32b82a5e3df3",
  "eventType": "client.created",
  "timestamp": "2025-10-10T16:20:33+02:00",
  "data": {
    "clientId": 362792,
    "triggeredBy": "API",
    "links": {
      "self": "https://apisandbox.mobile-calendar.com/v1/clients/362792"
    }
  }
}
```

{% endcode %}

### client.updated

Triggered when client details are changed.

{% code title="client.updated (sample payload)" %}

```json
{
  "webhookId": "c84a1d11-18a8-4210-93ef-b26b8a9f3ec9",
  "eventType": "client.updated",
  "timestamp": "2025-10-10T16:25:00+02:00",
  "data": {
    "clientId": 362792,
    "changedFields": ["email", "phone"],
    "triggeredBy": "API",
    "links": {
      "self": "https://apisandbox.mobile-calendar.com/v1/clients/362792"
    }
  }
}
```

{% endcode %}

### client.deleted

Triggered when a client is deleted.

{% code title="client.deleted (sample payload)" %}

```html
{
  "webhookId": "9d21f251-cde4-4f03-bb35-15cfb87c4ee9",
  "eventType": "client.deleted",
  "timestamp": "2025-10-10T16:30:00+02:00",
  "data": {
    "clientId": 362792,
    "triggeredBy": "MANUAL",
    "links": {
      "self": "https://apisandbox.mobile-calendar.com/v1/clients/362792"
    }
  }
}
```

{% endcode %}

***

## Room Events

### room.created

Triggered when a new room is added.

{% code title="room.created (sample payload)" %}

```json
{
  "webhookId": "7b3c41d3-7eaf-4f32-90f5-939c17c86b8c",
  "eventType": "room.created",
  "timestamp": "2025-10-10T16:35:00+02:00",
  "data": {
    "roomId": 28568,
    "roomTypeId": 102,
    "triggeredBy": "MANUAL",
    "links": {
      "self": "https://apisandbox.mobile-calendar.com/v1/rooms/28568"
    }
  }
}
```

{% endcode %}

### room.updated

Triggered when a new room is updated.

{% code title="room.updated (sample payload)" %}

```json
{
  "webhookId": "7b3c41d3-7eaf-4f32-90f5-939c17c86b8c",
  "eventType": "room.created",
  "timestamp": "2025-10-10T16:35:00+02:00",
  "data": {
    "roomId": 28568,
    "roomTypeId": 102,
    "changedFields": ["singleBed", "maxPerson"],
    "triggeredBy": "MANUAL",
    "links": {
      "self": "https://apisandbox.mobile-calendar.com/v1/rooms/28568"
    }
  }
}
```

{% endcode %}

### room.deleted

Triggered when a new room is deleted.

{% code title="room.deleted (sample payload)" %}

```json
{
  "webhookId": "7b3c41d3-7eaf-4f32-90f5-939c17c86b8c",
  "eventType": "room.created",
  "timestamp": "2025-10-10T16:35:00+02:00",
  "data": {
    "roomId": 28568,
    "roomTypeId": 102,
    "triggeredBy": "MANUAL",
    "links": {
      "self": "https://apisandbox.mobile-calendar.com/v1/rooms/28568"
    }
  }
}
```

{% endcode %}

***

## Message Events

### message.sent

Triggered when a message (email, SMS, chat) is sent.

{% code title="message.sent (sample payload)" %}

```json
{
  "webhookId": "b0d093f8-217c-41b1-bb12-dbe3eae2bfc6",
  "eventType": "message.sent",
  "timestamp": "2025-10-10T16:50:00+02:00",
  "data": {
    "messageId": 98123,
    "reservationId": 478652,
    "method": "EMAIL",
    "triggeredBy": "SYSTEM",
    "links": {
      "self": "https://apisandbox.mobile-calendar.com/v1/messages/98123"
    }
  }
}
```

{% endcode %}

***

## Availability Events

### availability.changed

Triggered when availability for rooms changes.

{% code title="availability.changed (sample payload)" %}

```json
{
  "webhookId": "f55b4a4b-548a-4c31-bbd6-f5d7e894312f",
  "eventType": "availability.changed",
  "timestamp": "2025-10-10T17:00:00+02:00",
  "data": {
    "roomId": [28568, 28569],
    "from": "2025-10-14",
    "to": "2025-10-20",
    "triggeredBy": "CHANNEL_MANAGER",
    "links": {
      "self": "https://apisandbox.mobile-calendar.com/v1/availability?roomId[]=28568&roomId[]=28569&from=2025-10-14&to=2025-10-20"
    }
  }
}
```

{% endcode %}

***

## Invoice Events

### invoice.created

Triggered when an invoice is created.

{% code title="invoice.created (sample payload)" %}

```json
{
  "webhookId": "a90e2a2d-782f-4d5d-8b1d-323bc5213123",
  "eventType": "invoice.created",
  "timestamp": "2025-10-10T17:10:00+02:00",
  "data": {
    "invoiceId": 6001,
    "reservationId": 478652,
    "triggeredBy": "MANUAL",
    "links": {
      "self": "https://apisandbox.mobile-calendar.com/v1/invoices/6001"
    }
  }
}
```

{% endcode %}

### invoice.updated

Triggered when an invoice is updated.

{% code title="invoice.updated (sample payload)" %}

```json
{
  "webhookId": "a90e2a2d-782f-4d5d-8b1d-323bc5213123",
  "eventType": "invoice.updated",
  "timestamp": "2025-10-10T17:10:00+02:00",
  "data": {
    "invoiceId": 6001,
    "reservationId": 478652,
    "triggeredBy": "MANUAL",
    "links": {
      "self": "https://apisandbox.mobile-calendar.com/v1/invoices/6001"
    }
  }
}
```

{% endcode %}

### invoice.deleted

Triggered when an invoice is deleted.

{% code title="invoice.deleted (sample payload)" %}

```json
{
  "webhookId": "a90e2a2d-782f-4d5d-8b1d-323bc5213123",
  "eventType": "invoice.deleted",
  "timestamp": "2025-10-10T17:10:00+02:00",
  "data": {
    "invoiceId": 6001,
    "reservationId": 478652,
    "triggeredBy": "MANUAL",
    "links": {
      "self": "https://apisandbox.mobile-calendar.com/v1/invoices/6001"
    }
  }
}
```

{% endcode %}

***

## Summary

Each webhook payload includes:

* A **unique webhookId**
* The **eventType**
* A **timestamp** (ISO8601 format)
* A **data** object with key entity identifiers
* A **links.self** URL for full data retrieval


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://mobile-calendar.gitbook.io/v1/webhooks/webhook-events.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.