Create Web Call | AgentPhone

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:

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

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

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

agentIdstringRequired

Agent ID to start the web call with

metadataobject or nullOptional

Optional metadata to attach to the call

variablesmap from strings to strings or nullOptional

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

Successful Response

Errors

422

Unprocessable Entity Error

1	import { AgentPhoneClient } from "agentphone";
2
3	async function main() {
4	const client = new AgentPhoneClient({
5	token: "YOUR_TOKEN_HERE",
6	});
7	await client.calls.createWebCall({
8	agentId: "agent_9f8b7c6d5e4a3b2c1d0e",
9	});
10	}
11	main();