View as Markdown
Vivomeetings icon

Vivomeetings ACTION

Create Conference

Creates a new conference in VivoMeetings. See the documentation
  • Action
  • Writes data
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Vivomeetings account once, then configure and run Create Conference from your backend or agent.

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: "vivomeetings-create-conference",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    vivomeetings: { authProvisionId: "apn_xxxxxxx" },
    companyId: "Company Id",
    hostId: "Host Id",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Create Conference inputs
Property Type Description
companyId Company Id string
The Id of the company.
Required
hostId Host Id string
The Id of the host.
Required Dynamic
subject Subject string
The subject of the meeting.
Required
agenda Agenda string
The description of the meeting.
Required
start Start string
Start time, this works in conjunction with the time_zone to set the correct time.
Required
timeZone Time Zone string
Time zone associated with the start time. In the IANA Time Zone database (https://www.iana.org/time-zones)
Required
duration Duration integer
Duration in minutes.
Required
autoRecord Auto Record string
Indicates whether the conference should be recorded automatically and the format. If omitted will default to none. Both record and stream must be the same value if recording and streaming together.
Optional
autoStream Auto Stream string
Indicates whether the conference should be streamed automatically and the format. If omitted will default to none. Both record and stream must be the same value if recording and streaming together.
Optional
autoTranscribe Auto Transcribe boolean
Whether the recording should automatically be transcribed. Valid values are true or false. If omitted will default to false.
Optional
oneTimeAccessCode One Time Access Code boolean
When set to true an access code will be returned in the response.
Required
secureUrl Secure URL boolean
When set to true the room_url will contain an encrypted access code. Best when used with one_time_access_code.
Optional
hostInitiatedRecording Host Initiated Recording boolean
Providing this parameter will change the trigger for automatically starting recording or streaming to also include the host joining the call.
Optional
securityPin Security Pin string
Pin required to access the conference.
Required
muteMode Mute Mode string
Sets the initial participant mute settings.
Required
participants Contact Ids string[]
The unique identification of the contacts.
Required Dynamic
participantEmails Participant Emails string[]
Alternatively participants can be listed via emails with moderators specified. If a participant’s emails is not on the host’s contact list, it will be added.
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
vivomeetings-create-conference
Version
0.0.2
App
Vivomeetings
Authentication
OAuth
Read-only
No
Destructive
No
Open world
Yes