Learn about the webhook requests issued to your marketplace application
When your marketplace application is activated by a Nexudus customer, you will be sent a request to your Notification URL endpoint every time a relevant change has been made in the inventory or booking calendar for that customer.
Feed notification
This notification is sent when changes in the resources, products, plans or events is made by a Nexudus customer who has enabled your marketplace application in their location.
{
"marketplace_id": "a6a8b2e2-xxx-bcd6dfdd1890",
"type": "feed",
"calendar_url": "https://spaces.nexudus.com/api/apps/marketplaceapplications/calendar?marketplaceId=a6a8b2e2-xxxx-b79b-bcd6dfdd1890&locationId=a596d492-xxxx-600ccf9a61e2",
"feed_url": "https://spaces.nexudus.com/api/apps/marketplaceapplications/feed?marketplaceId=a6a8b2e2-c855-xxxx-bcd6dfdd1890&locationId=a596d492-xxxx-600ccf9a61e2"
}
| Field | Description |
|---|---|
| marketplace_id | The id of the marketplace application being notified. |
| type | Always "feed" to indicate this is a feed update notification. |
Booking webhook
This notification is sent when a new booking is created, an existing booking is updated or deleted.
{
"booking": {
"id": "d9b8982f-xxxx-xxxx-e7eeb6b80fd3",
"from_time": "2022-03-18T15:15:00Z",
"to_time": "2022-03-18T16:15:00Z",
"from_time_local": "2022-03-18T08:15:00+00:00",
"to_time_local": "2022-03-18T09:15:00+00:00",
"customer": {
"id": "d086e74f-9811-4704-b7a0-f9643b7c888b"
},
"resource": {
"id": "8a0a7377-d8b5-41de-9342-4d531cecc0da",
"name": "Router Room"
}
},
"type": "bookingupdate"
}
| Field | Description |
|---|---|
| id | A unique id for the booking |
| from_time | The start date and time for this booking as UTC values. |
| to_time | The end date and time for this booking as UTC values. |
| from_time_local | The start date and time for this booking in the time zone of the location the booking takes place. |
| to_time_local | The end date and time for this booking in the time zone of the location the booking takes place. |
| customer.id | A unique reference for the customer who made this booking. If other bookings are made by this customer, this identifier is preserved. |
| resource.id | A unique id for the resource being booked |
| resource.name | The name of the resource being booked |
| type | The type of operation this notification is about bookingnew = A new booking was created bookingupdate = An existing booking was updated bookingdelete = An existing booking was deleted |