---
title: "Send the business's agent into a Zoom, Google Meet, Microsoft Teams or Webex meeting by link. It joins under the agent's name (the host admits it from a waiting room), takes notes, answers when addressed by name, and emails the owner a summary afterwards. Counts against the business's monthly meeting minutes (402 when none are left). Works with partner-scoped keys for the businesses the partner created. Admin role (session) or agents:write."
method: POST
path: "/v1/meetings"
---

# Send the business's agent into a Zoom, Google Meet, Microsoft Teams or Webex meeting by link. It joins under the agent's name (the host admits it from a waiting room), takes notes, answers when addressed by name, and emails the owner a summary afterwards. Counts against the business's monthly meeting minutes (402 when none are left). Works with partner-scoped keys for the businesses the partner created. Admin role (session) or agents:write.

`POST /v1/meetings`

## Request

- Base URL: `https://www.kaicalls.com/api`
- URL: `https://www.kaicalls.com/api/v1/meetings`
- Auth: HTTP bearer

## Request body

- object
  - `business_id` string, required
  - `meeting_url` string, uri, required
  - `agent_id` string
  - `bot_name` string: Speakable roster name override.
  - `camera_image_url` string, uri: Public https .jpg shown as the camera tile.
  - `instructions` string: Context for this meeting only.
  - `mode` 'listen' | 'avatar': 'listen': still camera tile, answers out loud when addressed. 'avatar': talking video face from a hosted assistant; counts as one avatar meeting (one lifetime free per business, then plan or purchased avatar meetings); 30 minutes on camera, then voice-only, ended at 60 minutes.
  - `avatar_id` string: Avatar mode: stock face id (400 lists the valid ids).

## Response `200`

Already joining this meeting (same link)

## Other responses

- `201`: Joining
- `400`: Unsupported link or invalid override
- `402`: No meeting minutes (or, in avatar mode, no avatar meetings) left
- `502`: The meeting provider could not start the session

---

[API](https://skmtc.dev/kaicalls/apis/kaicalls-public-api.md) · [All operations](https://skmtc.dev/kaicalls/apis/kaicalls-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kaicalls/apis/kaicalls-public-api/revisions/e607fc6cf36e?raw)