Update webhook
cooper_update_webhookDestructiveIdempotent
Use this when a webhook URL, event list, inbox filter, or enabled flag should change. Requires auth. Inputs: webhook_id (required), url (optional http(s) URL), events (optional array), enabled (optional boolean; true re-enables and resets consecutive_failures, false disables and stops deliveries), inbox_ids (optional; at most 10 inbox ids). Returns the webhook with the secret redacted. A disabled hook receives no deliveries. Fails with 404 webhook_not_found, 400 too_many_inboxes, 400 invalid_url, or 404 inbox_not_found.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"webhook_id": "<webhook_id>"
},
"name": "cooper_update_webhook"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | Replacement http(s) URL | |
| events | No | Replacement event list. At least one of message.received, message.held, message.sent, message.blocked, message.bounced, message.complained, task.received, owner.reply, domain.verified, draft.created, draft.approved, draft.rejected, draft.sent, account.sending_paused, account.sending_resumed, thread.assigned, thread.unassigned, thread.folder_updated, question.answered, or question.expired. | |
| enabled | No | true re-enables the hook and resets consecutive_failures to 0. false disables it. | |
| inbox_ids | No | Replacement inbox filter, at most 10 ids. An empty array matches every inbox. More than 10 returns 400 too_many_inboxes. | |
| webhook_id | Yes | Webhook id (wh_…) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Stable id of the returned object. Pass it to the matching get, update, or delete tool. | |
| url | No | URL that receives POST deliveries. | |
| events | No | Event types this object delivers. | |
| secret | No | Signing secret. Shown in full once on create or rotate, redacted otherwise. | |
| enabled | No | True when the object is active. | |
| headers | No | Extra delivery headers. Values are redacted. | |
| inbox_id | No | Inbox id (inb_…) this object belongs to. Null when it applies to every inbox. | |
| client_id | No | Caller idempotency key stored with the object, or null. | |
| inbox_ids | No | Inbox ids this object is limited to. Empty means every inbox on the account. | |
| created_at | No | ISO-8601 time the object was created. | |
| disabled_at | No | ISO-8601 time Cooper disabled the hook, or null. | |
| disabled_reason | No | Why the hook was disabled, or null. | |
| consecutive_failures | No | Failed deliveries in a row. | |
| previous_secret_active | No | True while deliveries are also signed with the previous secret. | |
| previous_secret_expires_at | No | ISO-8601 time the previous secret stops signing, or null. |