---
title: "Create external link"
method: POST
path: "/properties-api/listing-settings/external-links/{propertyId}"
tags: ["Listing external links"]
---

# Create external link

`POST /properties-api/listing-settings/external-links/{propertyId}`

Adds a new link to the property. url must include protocol (e.g. https://). name is the label shown to users (e.g. "House manual"). The new link is appended to the end; use PUT :propertyId/order to change order.

## Path parameters

- `propertyId` string, required

## Request body

- object
  - `url` string, uri, required — Full URL opened when the user clicks the link. Must include protocol (e.g. https://).
  - `name` string, required — Label shown for the link (e.g. "House manual", "Check-in guide"). Required; 1–500 characters.

## Response `201`

The created link with assigned id. Use this id for update (PUT), delete (DELETE), or reorder (PUT order).

- object
  - `id` string, required — Unique id of the link. Use for update (PUT :propertyId/:linkId), delete (DELETE), or reorder (PUT :propertyId/order).
  - `url` string, required — URL of the link (with protocol).
  - `name` string, required — Display name shown to users.

## Other responses

- `400` — Validation failed: url must be a valid URL with protocol; name required, 1–500 characters.
- `401` — Missing or invalid authentication. Account ID is required.
- `403` — You do not have permission to perform this action on the property.

---

[API](https://skmtc.net/guesty/apis/guesty-open-api.md) · [All operations](https://skmtc.net/guesty/apis/guesty-open-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/guesty/guesty-open-api/versions/7c62644070f2/schema)