Webhooks
Update webhook settings
Sets where events are delivered and which events to send. Use ["*"] to receive every event. See the Webhooks guide for setup and the Webhook events reference for each payload.
API key scope: webhook.update
Team role permission: webhook.update
PATCH
Update webhook settings
Authorizations
API key created in the dashboard under Settings → API keys. Each key carries permission scopes; every endpoint lists the scope it needs.
Query Parameters
Team to act in. Omit for your personal workspace. API keys created for a team use that team automatically.
Pattern:
^[a-fA-F0-9]{24}$Example:
"6a81bed11470bfcd2a5dbcfa"
Body
application/json
Available options:
*, project.created, project.updated, project.deleted, project.domain.updated, deployment.created, deployment.started, deployment.success, deployment.failed, environment.variables.added, environment.variables.updated, environment.variables.deleted, domain.created, domain.purchased, domain.renewed, domain.expired, dns.record.created, dns.record.updated, dns.record.deleted, database.created, database.backup.completed, autoscaling.group.created, autoscaling.group.updated, autoscaling.group.deleted, payment.successful, payment.failed Webhook URL must be a valid URL
Discord URL must be a valid URL
Slack URL must be a valid URL
Last modified on October 10, 2026