Create Or Update Webhook

POST

https://api.agentphone.ai/v1/webhooks

If a webhook already exists, it will be updated. A new secret is generated each time.

contextLimit: Number of recent messages to include in webhook payloads (0-50, default: 10). Set to 0 to disable history in webhooks.

AuthorizationBearer

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

X-Sub-Account-IdstringOptional

Target a sub-account. Pass a sub-account ID to scope this request. Omit to use the master account.

This endpoint expects an object.

urlstringRequiredformat: "uri"1-2083 characters

contextLimitinteger or nullOptional

timeoutinteger or nullOptional

Successful Response

idstring

urlstring

secretstring

statusstring

contextLimitinteger

timeoutinteger

createdAtdatetime

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.webhooks.createOrUpdateWebhook({
8	body: {
9	url: "string",
10	},
11	});
12	}
13	main();