Skip to main content
Manage platform webhooks from the command line. Platform webhooks push events from DevHelm to your HTTP endpoints — distinct from alert channel webhooks used for incident notifications.

​
Commands

CommandDescription
devhelm webhooks listList all webhooks
devhelm webhooks get <id>Get webhook details
devhelm webhooks createCreate a webhook
devhelm webhooks update <id>Update a webhook
devhelm webhooks delete <id>Delete a webhook
devhelm webhooks test <id>Send a test event

​
webhooks list

devhelm webhooks list

​
webhooks get

Webhook IDs are UUIDs — get them from devhelm webhooks list. 
devhelm webhooks get <webhook-id> -o json

​
webhooks create

devhelm webhooks create \
  --url https://hooks.example.com/devhelm \
  --events monitor.created,incident.created,incident.resolved
FlagTypeRequiredDescription
--urlstringYesEndpoint URL that receives event payloads (must be a valid HTTP(S) URL)
--eventsstringYesComma-separated list of subscribed events
--descriptionstring—Human-readable description
Valid event types (unknown values are rejected locally with the full list): monitor.created, monitor.updated, monitor.deleted, incident.created, incident.resolved, incident.reopened, service.status_changed, service.component_changed, service.incident_created, service.incident_updated, service.incident_resolved

​
webhooks update

devhelm webhooks update <webhook-id> \
  --events monitor.created,monitor.deleted,incident.created
Supports the same flags as create, all optional. --events replaces the full subscription list — include every event you still want.

​
webhooks delete

Prompts for confirmation; pass --yes (-y) in scripts and CI. 
devhelm webhooks delete <webhook-id>

​
webhooks test

Send a test event to verify the endpoint is reachable and responding correctly. 
devhelm webhooks test <webhook-id>

​
Next steps

Webhook integration

Payload format, HMAC signing, and event types.

Alert channels

Manage alert channel webhooks for incident notifications.