Create announcement
const url = 'https://api.wink.travel/api/managing-entity/d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69/extranet/announcement';const options = { method: 'POST', headers: { 'Wink-Version': '2.0', Authorization: 'Bearer <token>', 'Content-Type': 'application/json' }, body: '{"startDate":"","endDate":"","descriptions":[""],"showTitle":false,"showAlways":false}'};
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/announcement \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --header 'Wink-Version: 2.0' \ --data '{ "startDate": "", "endDate": "", "descriptions": [ "" ], "showTitle": false, "showAlways": false }'Creates a new date-based announcement for the given property from the supplied request. Announcements can be scheduled for specific date ranges or configured to always display. Requires CONTENT:WRITE on the managing entity. Returns HTTP 201 with the created announcement including its generated identifier.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ”Unique identifier of the property (managing entity) where the announcement will be created
Example
d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69Header Parameters
Section titled “Header Parameters ”Request Body required
Section titled “Request Body required ”object
Date when this announcement becomes active and visible to travelers.
Example
2026-03-01Date when this announcement expires and is no longer displayed.
Example
2026-04-15List of all localized announcements.
object
Use as title or short text description
Example
An example titleLonger text description
Example
This is a longer description in the specified language.Indicate which language this description is written in.
Example
enWhether it was user or system generated.
Example
SYSTEMThe md5 hash of the name, description and language.
When true, the announcement title is displayed to travelers; when false, only the description content is shown.
Example
trueWhen true, the announcement is always visible regardless of booking dates; when false, visibility is restricted to the configured start and end dates.
Example
falseResponses
Section titled “ Responses ”Announcement 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.
Unique identifier of the property (managing entity) for which this announcement is configured.
Date when this announcement becomes active and visible to travelers.
Date when this announcement expires and is no longer displayed.
List of all localized announcements.
object
Use as title or short text description
Longer text description
Indicate which language this description is written in.
Whether it was user or system generated.
The md5 hash of the name, description and language.
When true, the announcement title is displayed to travelers; when false, only the description content is shown.
When true, the announcement is always visible regardless of booking dates; when false, visibility is restricted to the configured start and end dates.
Example
{ "id": "", "createdDate": "", "lastUpdate": "", "version": "", "hotelIdentifier": "", "startDate": "", "endDate": "", "descriptions": [ "" ], "showTitle": false, "showAlways": false}Invalid request: missing required fields, invalid dates, or endDate not after startDate
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
Unauthorized
object
object
Insufficient permissions: CONTENT:WRITE not granted on the managing entity
object
object
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.
Unique identifier of the property (managing entity) for which this announcement is configured.
Date when this announcement becomes active and visible to travelers.
Date when this announcement expires and is no longer displayed.
List of all localized announcements.
object
Use as title or short text description
Longer text description
Indicate which language this description is written in.
Whether it was user or system generated.
The md5 hash of the name, description and language.
When true, the announcement title is displayed to travelers; when false, only the description content is shown.
When true, the announcement is always visible regardless of booking dates; when false, visibility is restricted to the configured start and end dates.
Example
{ "id": "", "createdDate": "", "lastUpdate": "", "version": "", "hotelIdentifier": "", "startDate": "", "endDate": "", "descriptions": [ "" ], "showTitle": false, "showAlways": false}Internal Server Error
object
Example generated
{}