---
title: "Create new link media item (VirtualTour or WebLink)."
method: POST
path: "/inventory/{inventoryId}/media-link"
tags: ["Media"]
---

# Create new link media item (VirtualTour or WebLink).

`POST /inventory/{inventoryId}/media-link`

## Request

- Base URL: `https://api.alto.zoopladev.co.uk`
- URL: `https://api.alto.zoopladev.co.uk/inventory/{inventoryId}/media-link`
- Auth: `appAuth` (a scheme the document does not define)

## Path parameters

- `inventoryId` integer, required

## Headers

- `AgencyRef` string, required

## Request body `application/x-www-form-urlencoded`

- object
  - `request` PostLinkMediaItemRequest, required
    - `mediaType` 'VirtualTour' | 'WebLink'
    - `description` string, nullable
    - `url` string, nullable

## Response `200`

The id of the new media

- PostLinkMediaItemResponse
  - `mediaId` integer

## Other responses

- `400`: When the request is invalid or MediaType is not VirtualTour or WebLink
- `401`: When access has not been granted
- `404`: The property is not found

---

[API](https://skmtc.dev/alto/apis/alto-api.md) - [All operations](https://skmtc.dev/alto/apis/alto-api/llms.txt) - [OpenAPI document](https://skmtc.dev/alto/apis/alto-api/revisions/1b729d9b15a8?raw)