Create
const url = 'https://api.wink.travel/api/managing-entity/d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69/wink-links/syndication/entry';const options = { method: 'POST', headers: { 'Wink-Version': '2.0', Authorization: 'Bearer <token>', 'Content-Type': 'application/json' }, body: '{"contentUrl":"https://www.thesiamresidences.com/explore","descriptions":[{"creator":"USER","description":"Spacious suite with floor-to-ceiling windows overlooking the Chao Phraya River, featuring a king-size bed, private balcony, and marble bathroom.","language":"en","md5ContentHash":"a3f1c8e2d74b60912a5c3e9b1d7f4e82","name":"Deluxe River View Suite"}],"disabled":false,"display":"Embedding a tweet","hashTags":["TravelSolo"],"lockCode":"ABC1234","multimedias":"For web links, it would be the Open Graph image url. For a file upload, it would be the multipart file.","publishDate":"2026-01-15T10:30:00Z","publishStatus":"PUBLISHED","sort":0,"tags":[{"label":"Hotel & Resort","value":"HOTEL"}],"title":"Explore Our Luxury Collection","type":"WEB_LINK","uniqueId":"siam1","userTags":["maniot"]}'};
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/wink-links/syndication/entry \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --header 'Wink-Version: 2.0' \ --data '{ "contentUrl": "https://www.thesiamresidences.com/explore", "descriptions": [ { "creator": "USER", "description": "Spacious suite with floor-to-ceiling windows overlooking the Chao Phraya River, featuring a king-size bed, private balcony, and marble bathroom.", "language": "en", "md5ContentHash": "a3f1c8e2d74b60912a5c3e9b1d7f4e82", "name": "Deluxe River View Suite" } ], "disabled": false, "display": "Embedding a tweet", "hashTags": [ "TravelSolo" ], "lockCode": "ABC1234", "multimedias": "For web links, it would be the Open Graph image url. For a file upload, it would be the multipart file.", "publishDate": "2026-01-15T10:30:00Z", "publishStatus": "PUBLISHED", "sort": 0, "tags": [ { "label": "Hotel & Resort", "value": "HOTEL" } ], "title": "Explore Our Luxury Collection", "type": "WEB_LINK", "uniqueId": "siam1", "userTags": [ "maniot" ] }'Creates a new WinkLinks entry from a fully specified upsert payload.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Create entry for this managing entity identifier.
Example
d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69Header Parameters
Section titled “Header Parameters”Request Bodyrequired
Section titled “Request Bodyrequired”WinkLinks entry to create
Request payload for creating or updating a syndicated item on a WinkLinks profile page.
object
The URL of this entry
Example
https://www.thesiamresidences.com/exploreLocalized descriptions describing inventory.
Foundation class for storing multi-language content (names and descriptions) with content change detection throughout the Wink Platform.
object
Whether it was user or system generated.
Example
SYSTEMLonger text description
Example
This is a longer description in the specified language.Indicate which language this description is written in.
Example
enThe md5 hash of the name, description and language.
Example
d41d8cd98f00b204e9800998ecf8427eUse as title or short text description
Example
An example titleExample
{ "creator": "USER", "description": "Spacious suite with floor-to-ceiling windows overlooking the Chao Phraya River, featuring a king-size bed, private balcony, and marble bathroom.", "language": "en", "md5ContentHash": "a3f1c8e2d74b60912a5c3e9b1d7f4e82", "name": "Deluxe River View Suite"}Whether author wants to disable the post.
Example
falseWhether to treat all links as flat web links or try to embed more advanced data.
Example
Embedding a tweetOptional code the author can require be entered by the user in order to access the post.
Example
ABC1234Extended metadata
object
The main media for this entry.
Multimedia that contains less information than Multimedia object
object
Media angle
Example
-90Whether image has attribution properties
object
Name of contributor
Example
Samuel AdamsURL to contributor
Example
https://maps.google.com/maps/contrib/111628493169070103594Example
{ "name": "Samuel Adams", "url": "https://maps.google.com/maps/contrib/111628493169070103594"}Localized media captions to give user some context about where this media was taken.
Foundation class for storing multi-language content (names and descriptions) with content change detection throughout the Wink Platform.
object
Whether it was user or system generated.
Example
SYSTEMLonger text description
Example
This is a longer description in the specified language.Indicate which language this description is written in.
Example
enThe md5 hash of the name, description and language.
Example
d41d8cd98f00b204e9800998ecf8427eUse as title or short text description
Example
An example titleExample
{ "creator": "USER", "description": "Spacious suite with floor-to-ceiling windows overlooking the Chao Phraya River, featuring a king-size bed, private balcony, and marble bathroom.", "language": "en", "md5ContentHash": "a3f1c8e2d74b60912a5c3e9b1d7f4e82", "name": "Deluxe River View Suite"}Media height in pixels.
Example
1600Use this identifier to communicate with Cloudinary.
Example
cloudinary-image-1True if media width is greater or equal to height
Example
trueAssociate this media with a specific lifestyle type. A user searching and filtering inventory based on lifestyles can be shown relevant media first.
Example
LIFESTYLE_HEALTH_FITNESSDocument identifier
Example
3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51Instead of deleting the media, choose to un-publish it instead for later re-use. Could be you keep seasonal images of the property.
Example
trueSort allows you to control how you want to sort this record in a list of media records.
Example
10Currently ONLY using Cloudinary to store all image / video assets.
Example
CLOUDINARYWhether Cloudinary media is a VIDEO or IMAGE.
Example
IMAGEMedia width in pixels.
Example
2560Example
{ "angle": null, "attribution": [], "category": "2", "descriptions": [ { "description": "Elegant lobby of The Siam Residences", "language": "en", "title": "Lobby Entrance" } ], "height": 1600, "identifier": "the-siam-residences/lobby-entrance", "isLandscape": true, "lifestyleType": null, "multimediaIdentifier": "3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51", "published": true, "sort": 10, "source": "CLOUDINARY", "type": "IMAGE", "width": 2560}Example
For web links, it would be the Open Graph image url. For a file upload, it would be the multipart file.An optional date for when this post will be displayed.
Example
2026-01-15T10:30:00ZPublish status of post.
Example
PUBLISHEDDisplay slot for this entry (0-based index)
Example
0Optional user categories
Immutable key-value pair associating a machine-readable value with a human-readable label.
object
English readable text of the value.
Example
Readable text labelThe value that should be persisted.
Example
id-1Example
{ "label": "Hotel & Resort", "value": "HOTEL"}The title of this entry
Example
Explore Our Luxury CollectionThe syndication entry type
Example
WEB_LINKOptional 5-character unique code that can be used to access this record.
Example
siam1Example
{ "contentUrl": "https://www.thesiamresidences.com/explore", "descriptions": [ { "creator": "USER", "description": "Spacious suite with floor-to-ceiling windows overlooking the Chao Phraya River, featuring a king-size bed, private balcony, and marble bathroom.", "language": "en", "md5ContentHash": "a3f1c8e2d74b60912a5c3e9b1d7f4e82", "name": "Deluxe River View Suite" } ], "disabled": false, "display": "Embedding a tweet", "hashTags": [ "TravelSolo" ], "lockCode": "ABC1234", "multimedias": "For web links, it would be the Open Graph image url. For a file upload, it would be the multipart file.", "publishDate": "2026-01-15T10:30:00Z", "publishStatus": "PUBLISHED", "sort": 0, "tags": [ { "label": "Hotel & Resort", "value": "HOTEL" } ], "title": "Explore Our Luxury Collection", "type": "WEB_LINK", "uniqueId": "siam1", "userTags": [ "maniot" ]}Responses
Section titled “Responses”WinkLinks entry created
Lightweight projection of a WinkLinks syndicated entry, representing a single link, card, map, file, or other content type displayed on an affiliate’s link-in-bio profile page.
object
The url of this entry
Datetime this record was first created
Localized descriptions describing inventory.
Foundation class for storing multi-language content (names and descriptions) with content change detection throughout the Wink Platform.
object
Whether it was user or system generated.
Longer text description
Indicate which language this description is written in.
The md5 hash of the name, description and language.
Use as title or short text description
Whether author wants to disable the post.
Whether to treat all links as flat web links or try to embed more advanced data.
Unique identifier for this record.
Datetime this record was last updated
Optional code the author can require be entered by the user in order to see the post.
Extended metadata
object
The main multimedias for this entry.
Multimedia that contains less information than Multimedia object
object
Media angle
Whether image has attribution properties
object
Name of contributor
URL to contributor
Supported OTA specification PIC code. See OTA geoname data
Localized media captions to give user some context about where this media was taken.
Foundation class for storing multi-language content (names and descriptions) with content change detection throughout the Wink Platform.
object
Whether it was user or system generated.
Longer text description
Indicate which language this description is written in.
The md5 hash of the name, description and language.
Use as title or short text description
Media height in pixels.
Use this identifier to communicate with Cloudinary.
True if media width is greater or equal to height
Associate this media with a specific lifestyle type. A user searching and filtering inventory based on lifestyles can be shown relevant media first.
Document identifier
Instead of deleting the media, choose to un-publish it instead for later re-use. Could be you keep seasonal images of the property.
Sort allows you to control how you want to sort this record in a list of media records.
Currently ONLY using Cloudinary to store all image / video assets.
Whether Cloudinary media is a VIDEO or IMAGE.
Media width in pixels.
The user’s owner company this entry associates with
An optional date for when this post will be displayed.
Publish status of post.
How the author wants this entry to get sorted
This can change if it’s linked to travel inventory that is no longer available.
Optional user categories
Immutable key-value pair associating a machine-readable value with a human-readable label.
object
English readable text of the value.
The value that should be persisted.
The site name of this entry
The syndication entry type
Optional unique code that can be used to access this record.
Creator of entry
Optimistic-locking version. Echo this value back as an If-Match request header on a conditional update; the server responds 409 if the record changed in the meantime. Null when this projection has no backing versioned document, in which case no conditional update is possible.
Example
{ "contentUrl": "https://www.google.com", "createdDate": "2026-01-14T09:30:00", "descriptions": [ { "creator": "USER", "description": "Spacious suite with floor-to-ceiling windows overlooking the Chao Phraya River, featuring a king-size bed, private balcony, and marble bathroom.", "language": "en", "md5ContentHash": "a3f1c8e2d74b60912a5c3e9b1d7f4e82", "name": "Deluxe River View Suite" } ], "disabled": false, "display": "Embedding a tweet", "hashTags": [ "#TravelSolo" ], "id": "b7e4c1a2-3f5d-4e8a-9c21-6f0b5d8e3a47", "lastUpdate": "2026-02-03T16:45:12", "lockCode": "ABC123", "multimedias": "For web links, it would be the Open Graph image url. For a file upload, it would be the multipart file.", "ownerIdentifier": "d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69", "publishDate": "2026-01-15T10:30:00Z", "publishStatus": "PUBLISHED", "sort": 0, "status": "ACTIVE", "tags": [ { "label": "Hotel & Resort", "value": "HOTEL" } ], "title": "Google", "type": "WEB_LINK", "uniqueId": "https://trvl.as/Hbgt56", "userIdentifier": "c3a9f2e1-8b4d-4c7a-a1e2-5f0b6d9e2c84", "userTags": [ "@maniot" ], "version": 3}Bad Request — missing or invalid request parameter or body
object
object
Examplegenerated
{ "detail": "example", "instance": "https://example.com", "properties": { "additionalProperty": "example" }, "status": 1, "title": "example", "type": "https://example.com"}Unauthorized — authentication is required or the session has expired
object
object
Examplegenerated
{ "detail": "example", "instance": "https://example.com", "properties": { "additionalProperty": "example" }, "status": 1, "title": "example", "type": "https://example.com"}Forbidden — authenticated but lacking the required permission or scope
object
object
Examplegenerated
{ "detail": "example", "instance": "https://example.com", "properties": { "additionalProperty": "example" }, "status": 1, "title": "example", "type": "https://example.com"}Not Found — the requested resource does not exist
object
object
Examplegenerated
{ "detail": "example", "instance": "https://example.com", "properties": { "additionalProperty": "example" }, "status": 1, "title": "example", "type": "https://example.com"}Method Not Allowed — the HTTP verb is not supported on this endpoint
object
object
Examplegenerated
{ "detail": "example", "instance": "https://example.com", "properties": { "additionalProperty": "example" }, "status": 1, "title": "example", "type": "https://example.com"}Conflict — the resource was modified by someone else since you read it; re-read it and retry with the new version
object
object
Examplegenerated
{ "detail": "example", "instance": "https://example.com", "properties": { "additionalProperty": "example" }, "status": 1, "title": "example", "type": "https://example.com"}Unsupported Media Type — use application/json
object
object
Examplegenerated
{ "detail": "example", "instance": "https://example.com", "properties": { "additionalProperty": "example" }, "status": 1, "title": "example", "type": "https://example.com"}Internal Server Error — an unexpected failure occurred on the server
object
object
Examplegenerated
{ "detail": "example", "instance": "https://example.com", "properties": { "additionalProperty": "example" }, "status": 1, "title": "example", "type": "https://example.com"}Service Unavailable — a downstream dependency is unreachable
object
object
Examplegenerated
{ "detail": "example", "instance": "https://example.com", "properties": { "additionalProperty": "example" }, "status": 1, "title": "example", "type": "https://example.com"}