---
title: "Create Or Update Agent Webhook"
method: POST
path: "/v1/agents/{agent_id}/webhook"
tags: ["agent-webhooks"]
---

# Create Or Update Agent Webhook

`POST /v1/agents/{agent_id}/webhook`

Register or update a webhook URL for a specific agent.

When set, this agent's events are delivered here instead of the account default webhook.

## Path parameters

- `agent_id` string, required

## Request body

- WebhookCreateRequest
  - `url` string, uri, required
  - `contextLimit` integer, nullable
  - `timeout` integer, nullable

## Response `200`

Successful Response

- WebhookResponse
  - `id` string, required
  - `url` string, required
  - `secret` string, required
  - `status` string, required
  - `contextLimit` integer, required
  - `timeout` integer, required
  - `createdAt` string, date-time, required

## 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)