Core resources


Administration


Booking flow

External calendars

Calendars which are being imported. Useful for syncing bookings with services like Airbnb or booking.com.

The external calendar object

Attributes

iduuid

Unique identifier

product_iduuid
products.id

Identifier of the product this calendar is related to

created_attimestamp with time zone

Creation timestamp

updated_attimestamp with time zone | null

Timestamp at which the calendar last received new events

activeboolean

Whether the external calendar is active

errortext | null

Error message if the calendar could not be synced

ical_urltext

URL of the iCal feed

last_syncedtimestamp with time zone | null

Timestamp at which the calendar was last synced

nametext | null

Name of the calendar

sync_requested_attimestamp with time zone | null

Timestamp at which a sync was last requested

time_offsetinteger
The external calendar object
{
"id": "00000000-0000-0000-0000-000000000000",
"product_id": "00000000-0000-0000-0000-000000000000",
"created_at": "2024-05-11T12:29:01.005Z",
"updated_at": "2024-05-11T12:29:01.005Z",
"active": true,
"error": "",
"ical_url": "",
"last_synced": "2024-05-11T12:29:01.005Z",
"name": "",
"sync_requested_at": "2024-05-11T12:29:01.005Z",
"time_offset": 0
}

List external calendars

Filters

idFilter<uuid>

Unique identifier

product_idFilter<uuid>

Identifier of the product this calendar is related to

created_atFilter<timestamp with time zone>

Creation timestamp

updated_atFilter<timestamp with time zone>

Timestamp at which the calendar last received new events

activeFilter<boolean>

Whether the external calendar is active

errorFilter<text>

Error message if the calendar could not be synced

ical_urlFilter<text>

URL of the iCal feed

last_syncedFilter<timestamp with time zone>

Timestamp at which the calendar was last synced

nameFilter<text>

Name of the calendar

sync_requested_atFilter<timestamp with time zone>

Timestamp at which a sync was last requested

time_offsetFilter<integer>

Responses

200

A list of external calendars with the selected columns

206

Partial Content

GET/external_calendars
curl -X GET "https://api.bookingmood.com/v1/external_calendars?select=*" \
  -H "Authorization: Bearer YOUR_API_KEY"

Create external calendars

Body

Partial<ExternalCalendar>
| Array<Partial<ExternalCalendar>>

Responses

201

The newly created external calendars with the selected columns

POST/external_calendars
curl -X POST "https://api.bookingmood.com/v1/external_calendars" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '[]'

Delete external calendars

Filters

idFilter<uuid>

Unique identifier

product_idFilter<uuid>

Identifier of the product this calendar is related to

created_atFilter<timestamp with time zone>

Creation timestamp

updated_atFilter<timestamp with time zone>

Timestamp at which the calendar last received new events

activeFilter<boolean>

Whether the external calendar is active

errorFilter<text>

Error message if the calendar could not be synced

ical_urlFilter<text>

URL of the iCal feed

last_syncedFilter<timestamp with time zone>

Timestamp at which the calendar was last synced

nameFilter<text>

Name of the calendar

sync_requested_atFilter<timestamp with time zone>

Timestamp at which a sync was last requested

time_offsetFilter<integer>

Responses

204

The deleted external calendars with the selected columns

DELETE/external_calendars
curl -X DELETE "https://api.bookingmood.com/v1/external_calendars" \
  -H "Authorization: Bearer YOUR_API_KEY"

Update external calendars

Filters

idFilter<uuid>

Unique identifier

product_idFilter<uuid>

Identifier of the product this calendar is related to

created_atFilter<timestamp with time zone>

Creation timestamp

updated_atFilter<timestamp with time zone>

Timestamp at which the calendar last received new events

activeFilter<boolean>

Whether the external calendar is active

errorFilter<text>

Error message if the calendar could not be synced

ical_urlFilter<text>

URL of the iCal feed

last_syncedFilter<timestamp with time zone>

Timestamp at which the calendar was last synced

nameFilter<text>

Name of the calendar

sync_requested_atFilter<timestamp with time zone>

Timestamp at which a sync was last requested

time_offsetFilter<integer>

Body

Partial<ExternalCalendar>

Responses

204

The updated external calendars with the selected columns

PATCH/external_calendars
curl -X PATCH "https://api.bookingmood.com/v1/external_calendars" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{}'