Navigation

Update Webhook

Modify an existing webhook configuration

POST /public/account/updateWebhook

Updates an existing webhook configuration. Only include the fields you want to change — omitted fields are left unchanged. Supports changing the name, endpoint URL, subscribed events, authentication type and credentials, timeout, and status.

Requires a valid api_key in the JSON request body

Tip: Send {"help": true} as the request body to receive full usage documentation and the complete list of supported events.

Parameters

Name In Type Required Description
api_key body string Yes Your Zyntro API key
org_id body string Yes Your organization UUID
wh_id body string Yes The UUID of the webhook to update
wh_name body string No New display name (max 100 characters)
wh_endpoint body string No New destination URL — must be a valid URL
wh_events body array No New array of event slugs. Replaces the entire event list — not additive.
wh_auth_type body string No New auth type: none, bearer, basic, api_key, or custom_header
wh_auth_data body object No New auth credentials matching the auth type
wh_timeout body integer No New timeout in seconds (5-120)
wh_status body string No New status: active, paused, or disabled

Warning: When updating wh_events, the new array replaces the existing event list entirely. If you want to add an event, you must include all existing events plus the new one. To see current events, use Fetch Webhooks first.

Request Body

Content-Type: application/json

Example

json 
{
    "wh_id": "d4e5f6a7-b8c9-0123-defg-456789012345",
    "org_id": "YOUR_ORG_ID",
    "api_key": "YOUR_API_KEY",
    "wh_events": [
        "new_contact",
        "form_filled",
        "invoice_paid",
        "subscription.created"
    ],
    "wh_status": "active"
}

Code Samples

bash 
curl -X POST https://app.zyntrohq.com/public/account/updateWebhook \
  -H "Content-Type: application/json" \
  -d '{"api_key": "YOUR_API_KEY", "org_id": "YOUR_ORG_ID", "wh_id": "d4e5f6a7-b8c9-0123-defg-456789012345", "wh_status": "paused"}'
bash 
curl -X POST https://app.zyntrohq.com/public/account/updateWebhook \
  -H "Content-Type: application/json" \
  -d '{"api_key": "YOUR_API_KEY", "org_id": "YOUR_ORG_ID", "wh_id": "d4e5f6a7-b8c9-0123-defg-456789012345", "wh_endpoint": "https://new-endpoint.example.com/webhook"}'

Response

200 Webhook updated
json 
{
    "data": {
        "wh_id": "d4e5f6a7-b8c9-0123-defg-456789012345",
        "action": "updated"
    },
    "status": "success",
    "message": "Webhook updated successfully"
}
200 No fields to update
json 
{
    "status": "error",
    "message": "No fields to update. Include at least one of: wh_name, wh_endpoint, wh_events, wh_auth_type, wh_auth_data, wh_timeout, wh_status"
}
200 Not found or access denied
json 
{
    "status": "error",
    "message": "Webhook not found or access denied"
}

Errors

Code Message Resolution
MISSING_API_KEY Missing API Key
The api_key is missing. 		Include your API key.
INVALID_API_KEY Invalid API Key
No active user matches. 		Verify your key.
MISSING_ORG Missing org ID
The org_id is missing. 		Include your org ID.
MISSING_WH_ID Missing webhook ID (wh_id)
The wh_id is missing. 		Provide the webhook UUID from Fetch Webhooks.
NOT_FOUND Webhook not found or access denied
No webhook with that ID belongs to the authenticated user in the specified org. 		Verify the wh_id and org_id.
INVALID_URL Invalid endpoint URL
The wh_endpoint is not a valid URL. 		Provide a valid URL.
INVALID_EVENTS Invalid event(s): ...
One or more event slugs are not recognized. 		Send {"help": true} to see supported events.
INVALID_AUTH Invalid wh_auth_type
The auth type is not recognized. 		Use: none, bearer, basic, api_key, or custom_header.
INVALID_STATUS Invalid wh_status
The status is not recognized. 		Use: active, paused, or disabled.
NO_FIELDS No fields to update
No updatable fields were included in the request. 		Include at least one field to change.
UPDATE_FAILED Failed to update webhook
Database update failed. 		Retry the request.
4 min read Updated Apr 2, 2026

Was this article helpful?

NotebookLM Overviews