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 project
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 project 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

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();