Create Agent | AgentPhone

Create a new agent.

An agent represents an AI persona (Support Bot, Sales Agent, etc.) that can have phone numbers attached to it.

voiceMode: “webhook” (default) forwards transcripts to your webhook. “hosted” uses a built-in LLM with systemPrompt (no webhook needed).

AuthorizationBearer

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

This endpoint expects an object.

namestringRequired

descriptionstring or nullOptional

voiceModestring or nullOptional

systemPromptstring or nullOptional

beginMessagestring or nullOptional

voicestring or nullOptional

Successful Response

idstring

namestring

descriptionstring or null

voiceModestring

voicestring

createdAtdatetime

systemPromptstring or null

beginMessagestring or null

numberslist of objects or null

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