> Markdown versions of all pages of this connector library are available by appending `.md` to the page URL. For the full index of connectors, see [llms.txt](https://connectors.appmixer.com/llms.txt).

# tl;dv connector

- Connector: `appmixer.tldv`
- Version: 1.0.2
- Components: 10 (1 trigger, 9 actions)

tl;dv is an AI meeting notetaker that joins Google Meet, Zoom and Microsoft Teams calls, records them, and produces transcripts and AI-generated notes and summaries. Read meetings, transcripts and notes, download recordings and import external recordings for transcription. API access requires a paid plan (Pro/Business/Enterprise) and depends on the meeting organizer's plan.

- Connector page: <https://connectors.appmixer.com/connector/appmixer.tldv/1.0.2>
- Source code: <https://github.com/clientIO/appmixer-connectors/tree/dev/src/appmixer/tldv>
- Download package: <https://connectors.appmixer.com/connector/appmixer.tldv/1.0.2/download>

## Authentication

**Type:** API Key

**Fields:**

- `API Key` (password): Log into tl;dv and open **Settings → Personal Settings → API Keys** ([tldv.io](https://tldv.io/app/settings/personal-settings/api-keys)), then click _Generate new API Key_. API access requires a paid plan (Pro, Business or Enterprise); the Free plan has no API access. Note that a meeting is only exportable via the API when its **organizer** is on a paid plan.

## Triggers (1)

- [New Meeting](https://connectors.appmixer.com/connector/appmixer.tldv/1.0.2/component/appmixer.tldv.core.NewMeeting.md) (`appmixer.tldv.core.NewMeeting`): Triggers when a new tl;dv meeting appears. Polls the meetings endpoint and emits each new meeting once. Note: only meetings whose organizer is on a paid plan are visible via the API.

## Actions (9)

- [Download Recording](https://connectors.appmixer.com/connector/appmixer.tldv/1.0.2/component/appmixer.tldv.core.DownloadRecording.md) (`appmixer.tldv.core.DownloadRecording`): Downloads a tl;dv meeting recording and stores it as a file, returning its file ID. Recordings can be large; the file is streamed rather than buffered.
- [Find Meetings](https://connectors.appmixer.com/connector/appmixer.tldv/1.0.2/component/appmixer.tldv.core.FindMeetings.md) (`appmixer.tldv.core.FindMeetings`): Search tl;dv meetings by free-text query, date range, meeting type and participation. Pages through all matches (up to the tl;dv 10,000 result ceiling).
- [Get Meeting](https://connectors.appmixer.com/connector/appmixer.tldv/1.0.2/component/appmixer.tldv.core.GetMeeting.md) (`appmixer.tldv.core.GetMeeting`): Retrieve a single tl;dv meeting by its ID, including organizer, invitees and template details.
- [Get Meeting Transcript](https://connectors.appmixer.com/connector/appmixer.tldv/1.0.2/component/appmixer.tldv.core.GetMeetingTranscript.md) (`appmixer.tldv.core.GetMeetingTranscript`): Retrieve the transcript of a tl;dv meeting. The transcript is only available once processing completes; if it is not ready yet the flow continues from the 'notReady' port instead of failing.
- [Get Meeting Notes](https://connectors.appmixer.com/connector/appmixer.tldv/1.0.2/component/appmixer.tldv.core.GetMeetingNotes.md) (`appmixer.tldv.core.GetMeetingNotes`): Retrieve the AI-generated notes of a tl;dv meeting: structured notes, topic summaries and a ready-to-use Markdown document you can push straight into a CRM, email or chat message.
- [Get Recording Download URL](https://connectors.appmixer.com/connector/appmixer.tldv/1.0.2/component/appmixer.tldv.core.GetRecordingDownloadUrl.md) (`appmixer.tldv.core.GetRecordingDownloadUrl`): Returns a temporary signed URL for downloading a tl;dv meeting recording. The URL is valid for about 6 hours — use it promptly or fetch a fresh one.
- [Import Meeting](https://connectors.appmixer.com/connector/appmixer.tldv/1.0.2/component/appmixer.tldv.core.ImportMeeting.md) (`appmixer.tldv.core.ImportMeeting`): Imports an external audio/video recording from a publicly reachable URL into tl;dv for transcription and AI notes. Supported formats: mp3, mp4, wav, m4a, mkv, mov, avi, wma, flac. Import is asynchronous: the job id is emitted immediately on the first output port, and once tl;dv finishes processing, the created meeting is emitted on the second (Meeting Created) port. On a dry run nothing is created and the second port never fires.
- [List Meetings](https://connectors.appmixer.com/connector/appmixer.tldv/1.0.2/component/appmixer.tldv.core.ListMeetings.md) (`appmixer.tldv.core.ListMeetings`): Lists all tl;dv meetings your API key can access, paging through the whole result set. tl;dv caps a single query at 10,000 results — use Find Meetings with a date range for larger accounts.
- [Make API Call](https://connectors.appmixer.com/connector/appmixer.tldv/1.0.2/component/appmixer.tldv.core.MakeApiCall.md) (`appmixer.tldv.core.MakeApiCall`): Performs an arbitrary authorized API call to the tl;dv API. Useful for reaching endpoints not yet covered by dedicated components, especially while the API is still in v1alpha1.

## Changelog

### 1.0.2

- Quote CSV cells that hold a comma, a double quote or a line break and map cells by header column when exporting results to a file.

### 1.0.1

- MakeApiCall: Request Headers and Query Parameters set in the Designer are now sent. They were silently dropped: the key-value field stores its rows as a JSON object string, which the component did not parse.

### 1.0.0

- Initial release. Actions: List Meetings, Find Meetings, Get Meeting, Get Meeting Transcript, Get Meeting Notes, Get Recording Download URL, Download Recording, Import Meeting and Make API Call. Trigger: New Meeting (polling). API-key authentication (x-api-key).
