# MeetStream Quickstart: Create Your First Bot

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

---

## 1) Sign up and create an API key

1. Sign up at **app.meetstream.ai**.
2. Open the **API** tab in the dashboard.
3. Click **Create API Key**.
4. Use this API key in the `Authorization` header for all API calls.

API Reference (all endpoints): https://docs.meetstream.ai/api-reference

---

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

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

### What you need to send

- `meeting_link`: paste the meeting link (Zoom / Google Meet / Microsoft Teams).
- `video_required`: set `true` if you want video, otherwise `false`.

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

### Example cURL

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

Once successful, you’ll receive a response containing details like the `bot_id`. Save it — you’ll use it to fetch audio/video or remove the bot.

---

## 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-reference/bot-endpoints/get-bot-audio

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

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

---

## 4) Remove/stop the bot

You can remove the bot using:  
https://docs.meetstream.ai/api-reference/api-reference/bot-endpoints/remove-bot

### Example cURL

```bash
curl -X POST "https://api.meetstream.ai/api/v1/bots/remove_bot" \
  -H "Authorization: Token <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "bot_id": "<BOT_ID>"
  }'
```

---

## Troubleshooting tips

- Double-check 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.

---

If you need more details, see the full docs: https://docs.meetstream.ai/api-reference