Get Started

Create Your First Meeting Bot

View as Markdown

MeetStream Quickstart: Create Your First Bot

This guide helps new MeetStream users create their first bot, join a meeting, and retrieve recordings.

Note: Dashboard Setup must be completed before proceeding with the below steps.

1) Create a bot (join Zoom / Google Meet / Microsoft Teams)

Use the Create Bot endpoint:
https://docs.meetstream.ai/api-reference/api-endpoints/bot-endpoints/create-bot

What you need to send

  • meeting_link (required): paste the meeting link (Zoom / Google Meet / Microsoft Teams).
  • bot_name (required): the display name the bot joins with.
  • video_required: set true if you want video, otherwise false.

Note: Currently MeetStream supports Google Meet, Zoom, and Microsoft Teams.

Example cURL

curl -X POST "https://api.meetstream.ai/api/v1/bots/create_bot" \
  -H "Authorization: Token <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "meeting_link": "<YOUR_MEETING_LINK>",
    "bot_name": "Notetaker",
    "video_required": false
  }'

A successful call returns HTTP 201 with the bot details, including the bot_id. Save it — every follow-up call (status, audio, video, remove) uses it.

Tip: need a meeting to test against? Open meet.new to spin up an instant Google Meet.

2) Check the bot’s status

While the meeting is running you can poll the bot’s state (joining, in call, recording, exited):

curl "https://api.meetstream.ai/api/v1/bots/<BOT_ID>/status" \
  -H "Authorization: Token <YOUR_API_KEY>"

Reference: https://docs.meetstream.ai/api-reference/api-endpoints/bot-endpoints/get-bot-status

3) Retrieve audio and video after the bot leaves

After the call ends (or the bot leaves), you can fetch recordings:

Get bot audio

https://docs.meetstream.ai/api-reference/api-endpoints/bot-endpoints/get-bot-audio

Get bot video

https://docs.meetstream.ai/api-reference/api-endpoints/bot-endpoints/get-bot-video

Depending on your setup, processing may take a short time after the bot exits.

4) Remove/stop the bot from an active meeting

Removing a bot is a simple GET with the bot_id in the path — no request body:

curl "https://api.meetstream.ai/api/v1/bots/<BOT_ID>/remove_bot" \
  -H "Authorization: Token <YOUR_API_KEY>"

Reference: https://docs.meetstream.ai/api-reference/api-endpoints/bot-endpoints/remove-bot

Troubleshooting tips

  • Double-check whether you’re using the correct API key and header format:
    • Authorization: Token <YOUR_API_KEY>
  • Ensure the meeting_link is a valid Zoom/GMeet/Teams meeting URL.
  • If video isn’t needed, keep video_required=false to reduce bandwidth and processing time.

Next steps

Full API reference: https://docs.meetstream.ai/api-reference