Create a new schedule item
const url = 'https://api.wink.travel/api/managing-entity/d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69/extranet/schedule/9c2e7f1a-4b8d-4e3c-a5f6-2d9b1e0c7a43';const options = { method: 'POST', headers: { 'Wink-Version': '2.0', Authorization: 'Bearer <token>', 'Content-Type': 'application/json' }, body: '{"start":"","end":"","startTimezone":"","endTimezone":"","isAllDay":false,"recurrenceRule":"","recurrenceId":"","recurrenceException":"","bookingIdentifier":"","type":"ROOM_TYPE_ANCILLARY","attendees":1}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://api.wink.travel/api/managing-entity/d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69/extranet/schedule/9c2e7f1a-4b8d-4e3c-a5f6-2d9b1e0c7a43 \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --header 'Wink-Version: 2.0' \ --data '{ "start": "", "end": "", "startTimezone": "", "endTimezone": "", "isAllDay": false, "recurrenceRule": "", "recurrenceId": "", "recurrenceException": "", "bookingIdentifier": "", "type": "ROOM_TYPE_ANCILLARY", "attendees": 1 }'Creates a new calendar item (schedule event) for a piece of inventory such as a meeting room, restaurant, spa, activity, attraction or place. The item is persisted and returned with a generated identifier. Supports recurring events via the recurrenceRule parameter.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ”Identifier of the managing entity (property/company) that owns the inventory
Example
d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69Identifier of the travel inventory to create a schedule item for
Example
9c2e7f1a-4b8d-4e3c-a5f6-2d9b1e0c7a43Header Parameters
Section titled “Header Parameters ”Request Body required
Section titled “Request Body required ”object
Start date and time of the scheduled event in ISO-8601 format.
Example
2026-02-15T14:00:00End date and time of the scheduled event in ISO-8601 format.
Example
2026-02-15T15:30:00Timezone identifier for the start time, using IANA time zone database format (e.g., Asia/Bangkok, America/New_York).
Example
Asia/BangkokTimezone identifier for the end time, using IANA time zone database format (e.g., Asia/Bangkok, America/New_York).
Example
Asia/BangkokFlag indicating whether this is an all-day event (no specific time). If true, time portions of start and end are ignored.
Example
trueRecurrence rule in iCalendar format (RFC 5545). If present, this event repeats according to the rule. For details see iCalendar specification. Null for non-recurring events.
Example
FREQ=DAILY;COUNT=5Identifier of the parent recurring event. Used when this instance is part of a recurring series.
Example
a2d5f8b1-1c4e-4d7a-8b3f-2e9a0c6b5d41List of date-times that are exceptions to the recurrence rule (dates when the recurring event does not occur).
Example
[ "2026-02-16T14:00:00", "2026-02-18T14:00:00"]Identifier of the booking this scheduled event is associated with.
Example
f4d1c8e5-2b9a-4f3d-9e7c-1b6a5d3f8c92Type of travel inventory (e.g., meeting room, restaurant, spa, activity, attraction, place).
Example
MEETING_ROOMNumber of guests or attendees for this event. Must be at least 1.
Example
2Responses
Section titled “ Responses ”Schedule item created successfully
object
Document UUID
Datetime this record was first created
Datetime this record was last updated
Version property that shows how many times this document has been persisted. Document will not persist if the version property is less than current version property in the system. Result in an optimistic locking exception.
Start date and time of scheduled event in ISO-8601 format.
Timezone identifier for the start time, using IANA time zone database format (e.g., Asia/Bangkok, America/New_York).
End date and time of scheduled event in ISO-8601 format.
Timezone identifier for the end time, using IANA time zone database format (e.g., Asia/Bangkok, America/New_York).
Flag indicating whether this is an all day event.
Title of scheduled event.
Description of scheduled event.
Recurrence rule in iCalendar format (RFC 5545). If present, indicates this is a recurring event. Null for non-recurring events. For details see iCalendar specification.
Identifier of the parent recurring event. Used when this instance is part of a recurring series.
List of date-times that are exceptions to the recurrence rule (dates when the recurring event does not occur).
Unique identifier of the travel inventory (meeting room, restaurant, spa, activity, etc.) that owns this schedule item.
Booking identifier that this scheduled event is associated with.
Identifier of the managing entity (company/organization) that owns this schedule item.
Identifier of the property (hotel) that owns the travel inventory.
The type of travel inventory.
Number of guests attending this event.
Email address of the person who scheduled or is managing this event.
Full name of the person who scheduled or is managing this event.
First name of the person who scheduled or is managing this event.
Last name of the person who scheduled or is managing this event.
Name of the venue where the scheduled event takes place.
Localized (translated) name of the venue in the local language.
Venue contact person
object
Contact first name
Contact last name
Contact E-mail
Contact secondary Email
Contact phone number
First and last name
Summary
Venue address
object
Address line 1
Address line 2
State
Postal / zip code
County
City name
Country
Country
Address 1, Address 2, City, State, Postal / Zip code, Country
Timestamp when this schedule item was created, in ISO-8601 format.
Timestamp when this schedule item was last modified, in ISO-8601 format.
Schedule event recurring sequence
Brand name to display in event notification emails and headers.
URL of the logo image to display in event notification email headers. Typically a Cloudinary CDN URL.
Cloudinary identifier for the logo image, used for referencing and potential reuse across notifications.
ISO 639-1 language code for the user’s preferred language in notifications (e.g., en, th, de).
Example
Invalid request body or parameters
object
object
Example generated
{ "type": "https://example.com", "title": "example", "status": 1, "detail": "example", "instance": "https://example.com", "properties": { "additionalProperty": "example" }}object
object
object
object
object
object
object
object
Authentication failed or missing
object
object
Insufficient permissions to create schedules for this inventory
object
object
Inventory or managing entity not found
object
Document UUID
Datetime this record was first created
Datetime this record was last updated
Version property that shows how many times this document has been persisted. Document will not persist if the version property is less than current version property in the system. Result in an optimistic locking exception.
Start date and time of scheduled event in ISO-8601 format.
Timezone identifier for the start time, using IANA time zone database format (e.g., Asia/Bangkok, America/New_York).
End date and time of scheduled event in ISO-8601 format.
Timezone identifier for the end time, using IANA time zone database format (e.g., Asia/Bangkok, America/New_York).
Flag indicating whether this is an all day event.
Title of scheduled event.
Description of scheduled event.
Recurrence rule in iCalendar format (RFC 5545). If present, indicates this is a recurring event. Null for non-recurring events. For details see iCalendar specification.
Identifier of the parent recurring event. Used when this instance is part of a recurring series.
List of date-times that are exceptions to the recurrence rule (dates when the recurring event does not occur).
Unique identifier of the travel inventory (meeting room, restaurant, spa, activity, etc.) that owns this schedule item.
Booking identifier that this scheduled event is associated with.
Identifier of the managing entity (company/organization) that owns this schedule item.
Identifier of the property (hotel) that owns the travel inventory.
The type of travel inventory.
Number of guests attending this event.
Email address of the person who scheduled or is managing this event.
Full name of the person who scheduled or is managing this event.
First name of the person who scheduled or is managing this event.
Last name of the person who scheduled or is managing this event.
Name of the venue where the scheduled event takes place.
Localized (translated) name of the venue in the local language.
Venue contact person
object
Contact first name
Contact last name
Contact E-mail
Contact secondary Email
Contact phone number
First and last name
Summary
Venue address
object
Address line 1
Address line 2
State
Postal / zip code
County
City name
Country
Country
Address 1, Address 2, City, State, Postal / Zip code, Country
Timestamp when this schedule item was created, in ISO-8601 format.
Timestamp when this schedule item was last modified, in ISO-8601 format.
Schedule event recurring sequence
Brand name to display in event notification emails and headers.
URL of the logo image to display in event notification email headers. Typically a Cloudinary CDN URL.
Cloudinary identifier for the logo image, used for referencing and potential reuse across notifications.
ISO 639-1 language code for the user’s preferred language in notifications (e.g., en, th, de).
Example
{ "id": "", "createdDate": "", "lastUpdate": "", "version": "", "start": "", "startTimezone": "", "end": "", "endTimezone": "", "isAllDay": false, "title": "", "description": "", "recurrenceRule": "", "recurrenceId": "", "recurrenceException": "", "ownerIdentifier": "", "bookingIdentifier": "", "bookingOwnerIdentifier": "", "hotelIdentifier": "", "type": "ROOM_TYPE_ANCILLARY", "attendees": 1, "email": "", "fullName": "", "firstName": "", "lastName": "", "venueName": "", "localizedVenueName": "", "contact": "", "address": null, "created": "", "lastModified": "", "sequence": 0, "brandName": "", "emailHeaderLogoUrl": "", "logoIdentifier": "", "language": ""}Internal Server Error
object
Example generated
{}