# Get Recording Download Link — Zoom

> Generate a temporary, pre-signed download link for one Zoom cloud recording file. Use to download, fetch, or share a recording. Call Get Meeting Recordings first to list a meeting's files and pass the id of the one you want, or omit…

- Key: `zoom-get-recording-download-link`
- Type: Action (Read-only)
- Version: 0.0.2
- App: Zoom (`zoom`) — https://pipedream.com/apps/zoom.md
- This page (HTML): https://pipedream.com/apps/zoom/actions/get-recording-download-link
- Hints: read-only · open-world
- Source: https://github.com/PipedreamHQ/pipedream/blob/master/components/zoom/actions/get-recording-download-link/get-recording-download-link.mjs

## Description

Generate a temporary, pre-signed download link for one Zoom cloud recording file. Use to download, fetch, or share a recording. Call **Get Meeting Recordings** first to list a meeting's files and pass the `id` of the one you want, or omit **Recording File** to get the meeting's main video recording automatically. Returns `downloadUrl`, `expiresAt`, `expiresInSeconds`, and the file's `recordingId`, `fileType`, `fileExtension`, `fileSize`, and recording start/end timestamps. **This link contains a credential — anyone who has it can download the file without logging in to Zoom, until it expires.** Example: call with meetingId=`84598792483` and no recording file → returns `{ downloadUrl: "https://us02web.zoom.us/rec/download/abc123?access_token=eyJ...", expiresInSeconds: 900, fileType: "MP4", fileSize: 148203910 }`. [See the documentation](https://developers.zoom.us/docs/api/meetings/#tag/cloud-recording/get/meetings/{meetingId}/recordings)

## Props

| Prop | Type | Required | Description |
|---|---|---|---|
| `meetingId` | `string` | Yes | The meeting whose recording you want a link for. For a recurring meeting, pass the meeting UUID (available from List All Recordings) to target a specific occurrence — the numeric meeting ID always returns the most recent one. Options are loaded from the connected account. |
| `recordingFileId` | `string` | No | The specific recording file to act on. Leave empty to use the meeting's main video recording (falls back to the largest MP4, then the audio-only file). To choose a file explicitly, call Get Meeting Recordings for the same meeting and pass one of the recording_files[].id values it returns (only files with status completed can be used). |
| `ttl` | `integer` | No | How long the link stays valid, in seconds. Defaults to 15 minutes (900). Minimum 60 (1 minute), maximum 604800 (7 days). |

## Run it

**MCP**

```ts
import { Client } from "@modelcontextprotocol/sdk/client/index.js"
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const accessToken = await pd.rawAccessToken

const transport = new StreamableHTTPClientTransport(
  new URL("https://remote.mcp.pipedream.net/v3"),
  {
    requestInit: {
      headers: {
        Authorization: `Bearer ${accessToken}`,
        "x-pd-project-id": process.env.PIPEDREAM_PROJECT_ID!,
        "x-pd-environment": "production",
        "x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
        "x-pd-app-slug": "zoom",
      },
    },
  },
)

const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)

const { tools } = await mcp.listTools()

// listTools() hands your model this tool's input schema, so it can
// fill the arguments itself:
const result = await mcp.callTool({
  name: "zoom-get-recording-download-link",
  arguments: {
    meetingId: "Meeting ID",
    recordingFileId: "Recording File",
  },
})
```

**TypeScript**

```ts
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "zoom-get-recording-download-link",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    zoom: { authProvisionId: "apn_xxxxxxx" },
    meetingId: "Meeting ID",
    recordingFileId: "Recording File",
  },
})

console.log(result)
```

**cURL**

```bash
curl -X POST https://api.pipedream.com/v1/connect/{project_id}/actions/run \
  -H "Content-Type: application/json" \
  -H "X-PD-Environment: production" \
  -H "Authorization: Bearer {access_token}" \
  -d '{
    "external_user_id": "{external_user_id}",
    "id": "zoom-get-recording-download-link",
    "configured_props": {
      "zoom": { "authProvisionId": "apn_xxxxxxx" },
      "meetingId": "Meeting ID",
      "recordingFileId": "Recording File"
    }
  }'
```

---

- App: https://pipedream.com/apps/zoom.md · All apps: https://pipedream.com/apps