> 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).

# Import Meeting

- Component: `appmixer.tldv.core.ImportMeeting`
- Kind: Action
- Version: 1.0.0
- Visibility: Public
- Connector: [appmixer.tldv 1.0.2](https://connectors.appmixer.com/connector/appmixer.tldv/1.0.2.md)
- Component page: <https://connectors.appmixer.com/connector/appmixer.tldv/1.0.2/component/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.

## Input ports

### Port `in`

| Field | Type | Description |
| --- | --- | --- |
| Name (`name`) | text | Name for the imported meeting. |
| Recording URL (`url`) | text | Publicly accessible URL of the audio/video file to import (mp3, mp4, wav, m4a, mkv, mov, avi, wma, flac). |
| Happened At (`happenedAt`) | date-time | Optional date/time when the meeting actually took place. |
| Participant Emails (`participants`) | text | Optional comma-separated list of participant email addresses. |
| Dry Run (`dryRun`) | toggle | When enabled, tl;dv validates the request without persisting anything. Useful for testing. |
| Correlation ID (`correlationId`) | text | Optional identifier of your own, echoed unchanged on both output ports. Use it to pair parallel imports with their results. |
| Polling Timeout (seconds) (`pollingTimeout`) | number | Maximum time to wait for tl;dv to finish processing the import. The meeting list is checked once a minute, so the effective resolution is 60 seconds and anything lower is raised to 60. When the timeout is reached the component fails; the import may still complete later - find it with Find Meetings (the meeting's Conference ID equals the job id) or the New Meeting trigger. |

## Output ports

### Port `out`

| Field | Type | Description |
| --- | --- | --- |
| Success (`success`) | boolean | - |
| Job ID (`jobId`) | string | - |
| Message (`message`) | string | - |
| Correlation ID (`correlationId`) | string | - |

### Port `done`

| Field | Type | Description |
| --- | --- | --- |
| Meeting ID (`id`) | string | - |
| Name (`name`) | string | - |
| Happened At (`happenedAt`) | string | - |
| tl;dv URL (`url`) | string | - |
| Duration (seconds) (`duration`) | integer | - |
| Organizer (`organizer`) | object | - |
| Invitees (`invitees`) | array | - |
| Template (`template`) | object | - |
| Extra Properties (`extraProperties`) | object | - |
| Job ID (`jobId`) | string | - |
| Correlation ID (`correlationId`) | string | - |

## Full metadata (component.json)

```json
{
  "name": "appmixer.tldv.core.ImportMeeting",
  "label": "Import Meeting",
  "description": "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.",
  "author": "Appmixer <info@appmixer.com>",
  "version": "1.0.0",
  "auth": {
    "service": "appmixer:tldv"
  },
  "inPorts": [
    {
      "name": "in",
      "schema": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "url": {
            "type": "string"
          },
          "happenedAt": {
            "type": "string",
            "format": "date-time"
          },
          "participants": {
            "type": "string"
          },
          "dryRun": {
            "type": "boolean"
          },
          "correlationId": {
            "type": "string"
          },
          "pollingTimeout": {
            "type": "number"
          }
        },
        "required": [
          "name",
          "url"
        ]
      },
      "inspector": {
        "inputs": {
          "name": {
            "type": "text",
            "index": 1,
            "label": "Name",
            "tooltip": "Name for the imported meeting."
          },
          "url": {
            "type": "text",
            "index": 2,
            "label": "Recording URL",
            "tooltip": "Publicly accessible URL of the audio/video file to import (mp3, mp4, wav, m4a, mkv, mov, avi, wma, flac)."
          },
          "happenedAt": {
            "type": "date-time",
            "index": 3,
            "label": "Happened At",
            "tooltip": "Optional date/time when the meeting actually took place."
          },
          "participants": {
            "type": "text",
            "index": 4,
            "label": "Participant Emails",
            "tooltip": "Optional comma-separated list of participant email addresses."
          },
          "dryRun": {
            "type": "toggle",
            "index": 5,
            "label": "Dry Run",
            "tooltip": "When enabled, tl;dv validates the request without persisting anything. Useful for testing."
          },
          "correlationId": {
            "type": "text",
            "index": 6,
            "label": "Correlation ID",
            "tooltip": "Optional identifier of your own, echoed unchanged on both output ports. Use it to pair parallel imports with their results."
          },
          "pollingTimeout": {
            "type": "number",
            "index": 7,
            "label": "Polling Timeout (seconds)",
            "defaultValue": 300,
            "tooltip": "Maximum time to wait for tl;dv to finish processing the import. The meeting list is checked once a minute, so the effective resolution is 60 seconds and anything lower is raised to 60. When the timeout is reached the component fails; the import may still complete later - find it with Find Meetings (the meeting's Conference ID equals the job id) or the New Meeting trigger."
          }
        }
      }
    }
  ],
  "outPorts": [
    {
      "name": "out",
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "title": "Success",
            "example": true
          },
          "jobId": {
            "type": "string",
            "title": "Job ID",
            "example": "job_657f1e2b9a1c4d0012ab34cd"
          },
          "message": {
            "type": "string",
            "title": "Message",
            "example": "Meeting import started."
          },
          "correlationId": {
            "type": "string",
            "title": "Correlation ID",
            "example": "order-1042"
          }
        }
      }
    },
    {
      "name": "done",
      "schema": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "Meeting ID",
            "example": "657f1e2b9a1c4d0012ab34cd"
          },
          "name": {
            "type": "string",
            "title": "Name",
            "example": "Acme <> Widgets weekly sync"
          },
          "happenedAt": {
            "type": "string",
            "format": "date-time",
            "title": "Happened At",
            "example": "2025-01-15T10:30:00Z"
          },
          "url": {
            "type": "string",
            "title": "tl;dv URL",
            "example": "https://tldv.io/app/meetings/657f1e2b9a1c4d0012ab34cd"
          },
          "duration": {
            "type": "integer",
            "title": "Duration (seconds)",
            "example": 1830
          },
          "organizer": {
            "type": "object",
            "title": "Organizer",
            "properties": {
              "name": {
                "type": "string",
                "title": "Name",
                "example": "Jane Doe"
              },
              "email": {
                "type": "string",
                "title": "Email",
                "example": "jane@acme.com"
              }
            }
          },
          "invitees": {
            "type": "array",
            "title": "Invitees",
            "items": {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string"
                },
                "email": {
                  "type": "string"
                }
              }
            },
            "example": [
              {
                "name": "John Smith",
                "email": "john@widgets.com"
              }
            ]
          },
          "template": {
            "type": "object",
            "title": "Template",
            "properties": {
              "id": {
                "type": "string",
                "title": "Template ID",
                "example": "tmpl_123"
              },
              "label": {
                "type": "string",
                "title": "Template Label",
                "example": "Sales Call"
              }
            }
          },
          "extraProperties": {
            "type": "object",
            "title": "Extra Properties",
            "properties": {
              "conferenceId": {
                "type": "string",
                "title": "Conference ID",
                "example": "abc-defg-hij"
              }
            }
          },
          "jobId": {
            "type": "string",
            "title": "Job ID",
            "example": "imjh-657f1e2b9a1c4d0012ab34cd"
          },
          "correlationId": {
            "type": "string",
            "title": "Correlation ID",
            "example": "order-1042"
          }
        }
      }
    }
  ],
  "icon": "(data URI omitted)"
}
```
