Meeting → Create
AI-generatedOverview
This node integrates with the Whereby video conferencing API to create new meetings. It allows users to specify meeting details such as the end date/time, room configuration, recording options, live transcription, and streaming settings. This node is useful for automating the scheduling and setup of video meetings within workflows, enabling seamless creation of customized meeting rooms without manual intervention.
Practical examples include:
- Automatically creating a meeting room with specific access controls and recording enabled when a calendar event is created.
- Setting up a group meeting with live transcription and streaming configured based on organizational preferences.
- Generating meetings with custom room name patterns and templates for different use cases like webinars or team calls.
Properties
| Name | Meaning |
|---|---|
| End Date | The end date and time for the meeting (required). |
| Additional Fields | Optional extra settings for the meeting room: - Is Locked: Whether the room should be locked initially. - Room Mode: "Normal" (standard) or "Group" (enhanced features). - Room Name Prefix: Alphanumeric prefix for the room name (max 39 characters). - Room Name Pattern: Pattern for generating room names, either "UUID" or "Human Short". - Template Type: Template for the meeting room, currently only "Viewer Mode". - Response Fields: Additional fields to include in the response, such as "Host Room URL" and "Viewer Room URL". |
| Recording Settings | Configure recording options: - Recording Type: "None", "Local" (on participant device), or "Cloud" (stored in Whereby). - Start Trigger: When to start recording ("Use Organization Default", "None", "Prompt", "Automatic", "Automatic (2nd Participant)"). Only shown if recording type is not "none". |
| Live Transcription Settings | Configure live transcription: - Start Trigger: When to start transcription ("Use Organization Default", "None", "Manual", "Automatic", "Automatic (2nd Participant)"). - Language: Language code for transcription (e.g., "en" for English). - Live Captions: Enable live captions during the meeting (boolean). Shown only if start trigger is manual or automatic. |
| Streaming Settings | Configure streaming options: - Start Trigger: When to start streaming ("Use Organization Default", "None", "Prompt", "Automatic"). |
Output
The output JSON contains the full response from the Whereby API after creating a meeting. This typically includes:
- Meeting identifiers and metadata.
- URLs for host and viewer rooms if requested.
- Configuration details reflecting the input parameters.
No binary data output is produced by this operation.
Dependencies
- Requires an API key credential for authenticating with the Whereby API.
- The node uses internal helper functions to make HTTP requests to the Whereby API endpoints.
- No additional external dependencies beyond the API key and network access to Whereby services.
Troubleshooting
- Common issues:
- Invalid or missing API credentials will cause authentication errors.
- Providing invalid date formats or missing required fields (like End Date) will result in validation errors.
- Using unsupported room name prefixes or patterns may cause API rejections.
- Error messages:
- Authentication failures: Check that the API key credential is correctly configured.
- Validation errors: Ensure all required properties are set and follow expected formats.
- Network errors: Verify internet connectivity and API endpoint availability.