---
title: "Create a public itinerary link"
method: POST
path: "/api/trips/{id}/itinerary-links"
tags: ["Sharing"]
---

# Create a public itinerary link

`POST /api/trips/{id}/itinerary-links`

## Request

- Base URL: `https://trvlrr.app`
- URL: `https://trvlrr.app/api/trips/{id}/itinerary-links`
- Auth: HTTP bearer

A 128-bit token is the credential; the page shows the itinerary without booking references, traveller names, notes or photos. Prices are opt-in; transport, stays and activities are on unless turned off.

## Path parameters

- `id` string, required: The trip id.

## Request body

- ShareOptionsInput
  - `prices` boolean: Show prices (opt-in).
  - `segments` boolean
  - `stays` boolean
  - `activities` boolean

## Response `201`

The link.

- ItineraryLink
  - `token` string, required
  - `url` string, required
  - `options` ShareOptions, required
    - `prices` boolean, required: Show prices (opt-in).
    - `segments` boolean, required
    - `stays` boolean, required
    - `activities` boolean, required
  - `created_at` string

## Other responses

- `401`: No usable credential: a Clerk session token, a device token or an OAuth access token is required.
- `403`: The caller may not do this to this account or trip.
- `404`: No such thing, or not one the caller can see.

---

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