---
title: "Create presentation link"
method: POST
path: "/api/v1/presentations/{presentation_id}/managed-links"
tags: ["Presentations"]
---

# Create presentation link

`POST /api/v1/presentations/{presentation_id}/managed-links`

## Request

- Base URL: `https://api.pitch.com`
- URL: `https://api.pitch.com/api/v1/presentations/{presentation_id}/managed-links`
- Auth: one of:
  - API key in header `X-API-KEY`
  - HTTP bearer

Create a link for an existing presentation.

## Path parameters

- `presentation_id` string, uuid, required

## Request body

- object, nullable
  - `name` string: Display label for the link. Defaults to the presentation name.
  - `slug` string: Human-readable portion of the link URL. A random suffix is always appended, so collisions are impossible. Defaults to the presentation name.
  - `options` object: Link configuration. All booleans default to false, e.g. `{"collect_engagement_analytics": true, "require_passcode": true, "passcode": "q3-acme"}`.
    - `allow_duplication` boolean
    - `collect_engagement_analytics` boolean
    - `require_visitor_consent_for_analytics` boolean
    - `require_passcode` boolean
    - `passcode` string: Only valid when require_passcode is true.
    - `require_visitor_email` boolean
    - `allow_pdf_download` boolean
    - `disable_after` string, date-time, nullable: ISO 8601 datetime after which the link stops resolving. Must be in the future. Null for no expiry.

## Response `201`

- object
  - `managed_link` object, required
    - `link_id` string, uuid, required
    - `presentation_id` string, uuid, required
    - `name` string, required
    - `slug` string, nullable, required
    - `url` string, required
    - `disabled` boolean, required
    - `options` object, required
      - `allow_duplication` boolean, required
      - `collect_engagement_analytics` boolean, required
      - `require_visitor_consent_for_analytics` boolean, required
      - `require_passcode` boolean, required
      - `require_visitor_email` boolean, required
      - `allow_pdf_download` boolean, required
      - `disable_after` string, date-time, nullable, required
    - `created_at` string, date-time, required
    - `id` string, uuid, required: Deprecated — use link_id.

## Other responses

- `400`
- `401`
- `403`
- `404`

---

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