---
title: "Create a public shortlist that expires after 30 days. Idempotent with Idempotency-Key."
method: POST
path: "/share"
tags: ["Share"]
---

# Create a public shortlist that expires after 30 days. Idempotent with Idempotency-Key.

`POST /share`

## Request

- Base URL: `https://ecoaloha.com/api/v1`
- URL: `https://ecoaloha.com/api/v1/share`
- Auth: none required

Create a public shortlist that expires after 30 days. Idempotent with Idempotency-Key. Requires partner access; returns 503 AGENT_ACCESS_NOT_APPROVED until enabled. Rate limited. Sandbox: X-Sandbox: true returns fixture data.

## Headers

- `X-Sandbox` 'true'
- `Idempotency-Key` string

## Request body

- object
  - `experienceIds` string[], required
  - `currency` 'EUR' | 'USD' | 'GBP': Display currency for prices.

## Response `201`

Created. Keep deletionToken private.

- object
  - `data` ShareCreated, required
    - `id` string, required
    - `url` string, uri, required
    - `deletionToken` string, required: Private. Needed to delete the list. Do not publish.
    - `expiresAt` string, date-time, required

## Other responses

- `400`: Invalid input.
- `404`: Not found.
- `429`: Rate limited.
- `503`: Partner access is not enabled. The error includes a docs URL.

---

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