---
title: "Create Web Call"
method: POST
path: "/v1/calls/web"
tags: ["calls"]
---

# Create Web Call

`POST /v1/calls/web`

Create a browser-based web call.

Returns an access token that your frontend passes to the AgentPhone Web SDK
(`agentphone-web-sdk`) to start the call in the browser. The token
expires 30 seconds after creation.

Flow:
1. Validates the agent belongs to your account
2. Creates a web call and returns an access token
3. Your client calls `webClient.startCall({ accessToken })` to connect
4. Call lifecycle (transcripts, webhooks) works the same as phone calls

## Request body

- CreateWebCallRequest — Request model for creating a browser-based web call.
  - `agentId` string, required — Agent ID to start the web call with
  - `metadata` object, nullable — Optional metadata to attach to the call
  - `variables` object, nullable — Optional per-call dynamic variables. Values are substituted into ``{{var_name}}`` placeholders in the agent's system prompt and begin message at call time. Requires a hosted-mode agent.

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/agentphone/apis/agentphone-api.md) · [All operations](https://skmtc.net/agentphone/apis/agentphone-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/agentphone/agentphone-api/versions/5724ccaa33d8/schema)