Skip to main content
PATCH
/
api
/
webhooks
/
{id}
Update Webhook
curl --request PATCH \
  --url https://app.tuco.ai/api/webhooks/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "url": "<string>",
  "events": [
    "<string>"
  ],
  "name": "<string>",
  "description": "<string>",
  "isActive": true
}
'
Update any combination of fields on an existing webhook. Only include the fields you want to change.

​
Authentication

Authorization: Bearer tuco_sk_xxxxxxxxxxxxx

​
Path parameters

​
id
string
required
Webhook ID.

​
Request body

All fields are optional. Include only what you want to change.
​
url
string
New endpoint URL.
​
events
string[]
New event subscriptions. Replaces the existing list (not a merge). Valid values: message.sent, message.failed, message.fallback, message.reply, message.opened.
​
name
string
New name.
​
description
string
New description.
​
isActive
boolean
Set false to pause delivery without deleting the webhook. Set true to resume.

​
Examples

curl -X PATCH "https://app.tuco.ai/api/webhooks/680a1b2c3d4e5f6789012345" \
  -H "Authorization: Bearer tuco_sk_xxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{ "isActive": false }'
200 Response
{ "success": true }

​
Errors

StatusWhen
400Invalid URL, empty events array, invalid event types, empty name
401Invalid or missing API key
402Subscription past due
404Webhook not found in your workspace