Scheduling Meetings

Schedule VoxeNova to join your meetings via the REST API or a chat integration. The AI facilitator will join the call automatically at the scheduled time.

Via API

Create a scheduled meeting with a single POST request:

      bash
      curl -X POST https://{your-slug}.voxenova.com/api/v1/schedule \
  -H "Authorization: Bearer sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "meeting_url": "https://zoom.us/j/123456789",
    "meeting_type": "product_discovery",
    "scheduled_at": "2026-03-15T14:00:00Z",
    "duration_minutes": 60
  }'
    

Required Fields

Field	Type	Description
`meeting_url`	string	Zoom, Teams, or Google Meet link
`meeting_type`	string	One of: `product_discovery`, `sprint_inception`, `architecture_review`, `process_mapping`, `executive_assistant`
`scheduled_at`	ISO 8601	UTC start time
`duration_minutes`	integer	Expected duration (max depends on plan)

Via Slack

If you've connected the Slack integration, use the slash command:

      slack
      /voxenova schedule https://zoom.us/j/123456789 tomorrow 2pm
    

You can also send a natural-language DM to the VoxeNova bot:

      slack
      Schedule a product discovery meeting for https://zoom.us/j/123456789 at 3pm on Friday
    

Via Google Chat

Message the VoxeNova bot in your Google Chat space with natural language:

      google chat
      @VoxeNova schedule a sprint inception at https://meet.google.com/abc-defg-hij for Monday 10am
    

Listing Meetings

      bash
      curl -s https://{your-slug}.voxenova.com/api/v1/schedule \
  -H "Authorization: Bearer sk_your_api_key" | python3 -m json.tool
    

Cancelling a Meeting

      bash
      curl -X DELETE https://{your-slug}.voxenova.com/api/v1/schedule/{meeting_id} \
  -H "Authorization: Bearer sk_your_api_key"
    

Status Lifecycle

Meetings progress through these states:

Status	Description
`pending`	Scheduled, waiting for start time
`launching`	Bot is joining the meeting
`active`	Meeting in progress, AI facilitating
`completed`	Meeting ended, artefacts delivered
`failed`	Could not join or unexpected error

Via Calendar

For more ways to join meetings — including email invite and calendar OAuth — see the Calendar Integration guide.

Next Steps

Upload documents so the AI has context for your meetings
Learn about meeting types to pick the right one
Set up chat integrations for scheduling from Slack or Teams