⚡Webhooks

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