---
title: "Recorder Website Invitation Create"
method: POST
path: "/api/organizations/{orgHandle}/recording-invitations"
tags: ["Recording invitations"]
---

# Recorder Website Invitation Create

`POST /api/organizations/{orgHandle}/recording-invitations`

## Request

- Base URL: `https://mcp.usertold.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://mcp.usertold.ai/api/organizations/{orgHandle}/recording-invitations`
- Auth: none declared

Execute the UserTold recorder website invitation create operation.

## Path parameters

- `orgHandle` string, required: orgHandle path parameter

## Request body

- object
  - `targetUrl` string, uri, required
  - `externalRef` string, required
  - `title` string
  - `instructions` string[]
  - `expiresInDays` integer

## Response `200`

Success

- object
  - `id` string, required
  - `projectRef` string, required
  - `externalRef` string, nullable, required
  - `plan` object, required
    - `version` 1, required
    - `title` string, required
    - `targetUrl` string, uri, required
    - `steps` object[], required
      - `instruction` string, required
      - `url` string, uri
  - `launchUrl` string, required
  - `instructions` string, required
  - `expiresAt` string, required
  - `revoked` boolean, required
  - `status` 'invited' | 'started' | 'uploading' | 'completed' | 'expired' | 'revoked' | 'deleted', required
  - `interviewRef` string, nullable, required
  - `interviewUrl` string, nullable, required
  - `viewUrl` string, nullable, required

## Other responses

- `401`: Not authenticated
- `404`: Not found
- `422`: Domain error (non-retryable)
- `500`: Internal server error
- `503`: Domain error (retryable)

---

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