Create
const url = 'https://api.wink.travel/api/managing-entity/d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69/studio/map';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 \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --header 'Wink-Version: 2.0' \ --data nullCreate a new map configuration owned by the specified managing entity with the supplied settings.
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”Map configuration including name, center coordinates, zoom level, style and the list of inventory items to display as markers
Request to create or update a map configuration for displaying inventory
object
GeoJSON point defining map center (longitude, latitude)
object
Example
{ "coordinates": [ 100.5581533, 13.7370197 ], "type": "Point"}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
Category of inventory being displayed (SINGLE, LIST, or SEARCH)
Example
LISTUUID of the inventory source: single channel inventory, curated list, or dynamic search
Example
7a0c5d9e-2f6b-4c1a-8e4d-3b9f1a0c6d52Allow users to zoom in and out
Example
trueExample
{ "center": { "coordinates": [ 100.5581533, 13.7370197 ], "type": "Point" }, "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", "type": "LIST", "typeIdentifier": "7a0c5d9e-2f6b-4c1a-8e4d-3b9f1a0c6d52", "zoomable": true}Responses
Section titled “Responses”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