Create (supplier)
const url = 'https://api.wink.travel/api/managing-entity/d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69/studio/map/supplier';const options = { method: 'POST', headers: { 'Wink-Version': '2.0', Authorization: 'Bearer <token>', 'Content-Type': 'application/json' }, body: 'null'};
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/studio/map/supplier \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --header 'Wink-Version: 2.0' \ --data nullCreate a new map centered on a supplier property with a single marker, priced to its best-available rate for the requested inventory type.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”UUID of the managing entity that will own the map.
Example
d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69Header Parameters
Section titled “Header Parameters”Request Bodyrequired
Section titled “Request Bodyrequired”Supplier map request including the property identifier, inventory type and optional display settings used to center and price the map marker
Request to create a map for a single supplier property
object
Optional circular overlay regions on the map
object
Circle center point
object
Circle radius from center
Example
2.5Example
{ "radius": 2.5}UUID of the customization context (e.g., Wink Links, channel manager)
Example
3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51Which data to display initially (NATIVE, MODIFIED, or AFFILIATE)
Example
NATIVEAllow users to pan the map by dragging
Example
trueInitial zoom level (0-21, where 0 shows the entire world)
Example
15Height of the embedded map in pixels
Example
500Hexadecimal color code for map markers
Example
cc2138Map visual style (normal, clean, or bluish)
Example
normalOptional custom markers to display on the map
object
A GeoJSON point
object
Display name for this map
Example
Premium Hotels in Southeast AsiaOptional polygonal overlay regions on the map
object
A GeoJSON polygon
object
object
object
object
Optional rectangular overlay regions on the map
object
A GeoJSON rectangle
object
North-east corner of the geographic bounding rectangle
object
South-west corner of the geographic bounding rectangle
object
UUID of the supplier property to display on the map
Example
e2c7b4d3-1a8f-4e9c-b5d6-3a9f0e7c2b18Type of inventory to display from the supplier (GUEST_ROOM, ACTIVITY, SPA, etc.)
Example
GUEST_ROOMAllow users to zoom in and out
Example
trueExample
{ "circles": [ { "radius": 2.5 } ], "customizationIdentifier": "3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51", "displayType": "NATIVE", "draggable": true, "initialZoomLevel": 15, "mapHeight": 500, "mapMarkerColor": "cc2138", "mapStyle": "normal", "name": "Premium Hotels in Southeast Asia", "supplierIdentifier": "e2c7b4d3-1a8f-4e9c-b5d6-3a9f0e7c2b18", "type": "GUEST_ROOM", "zoomable": true}Responses
Section titled “Responses”Supplier map configuration created successfully
object
GeoJSON point defining map center (longitude, latitude)
object
Optional circular overlay regions on the map
object
Circle center point
object
Circle radius from center
UUID of the customization context (e.g., Wink Links, channel manager)
Which data to display initially (NATIVE, MODIFIED, or AFFILIATE)
Allow users to pan the map by dragging
Unique identifier of this map (assigned by server)
Initial zoom level (0-21, where 0 shows the entire world)
Height of the embedded map in pixels
Hexadecimal color code for map markers
Map visual style (normal, clean, or bluish)
Optional custom markers to display on the map
object
A GeoJSON point
object
Display name for this map
UUID of the managing entity that owns this map
Optional polygonal overlay regions on the map
object
A GeoJSON polygon
object
object
object
object
Optional rectangular overlay regions on the map
object
A GeoJSON rectangle
object
North-east corner of the geographic bounding rectangle
object
South-west corner of the geographic bounding rectangle
object
Category of inventory being displayed (SINGLE, LIST, or SEARCH)
UUID of the inventory source: single channel inventory, curated list, or dynamic search
Allow users to zoom in and out
Example
Bad Request — missing or invalid request parameter or body
object
object
Example
Unauthorized — authentication is required or the session has expired
object
object
Example
Forbidden — authenticated but lacking the required permission or scope
object
object
Example
Not Found — the requested resource does not exist
object
object
Example
Method Not Allowed — the HTTP verb is not supported on this endpoint
object
object
Example
Conflict — the resource was modified by someone else since you read it; re-read it and retry with the new version
object
object
Example
Unsupported Media Type — use application/json
object
object
Example
Internal Server Error — an unexpected failure occurred on the server
object
object
Example
Service Unavailable — a downstream dependency is unreachable