Webhook payload reference

Coolify sends webhook notifications as JSON POST requests to the endpoint configured under Notifications > Webhook. Follow Webhook setup before using this reference.

Requests use the Content-Type: application/json header. Every payload includes these fields:

Field	Type	Description
`success`	boolean	`true` for success events; `false` for failures and alerts.
`event`	string	Machine-readable event identifier.
`message`	string	Human-readable event summary.

Select an event identifier in each section to inspect its request body and conditional fields.

Application deployments and status

Sent when an application deployment completes successfully.

{
  "success": true,
  "event": "deployment_success",
  "message": "New version successfully deployed",
  "application_name": "my-app",
  "application_uuid": "...",
  "deployment_uuid": "...",
  "deployment_url": "...",
  "project": "...",
  "environment": "...",
  "fqdn": "..."
}

Pull request previews

Pull request preview deployments add these fields:

{
  "pull_request_id": 123,
  "preview_fqdn": "..."
}

fqdn is included when the application has a domain. It may be absent from either regular or preview deployment payloads.

Database backups

Sent when a database backup completes successfully.

{
  "success": true,
  "event": "backup_success",
  "message": "Database backup successful",
  "database_name": "...",
  "database_uuid": "...",
  "database_type": "...",
  "frequency": "...",
  "url": "..."
}

Scheduled tasks

Sent when a scheduled task completes successfully.

{
  "success": true,
  "event": "task_success",
  "message": "Scheduled task succeeded",
  "task_name": "...",
  "task_uuid": "...",
  "output": "...",
  "application_uuid": "...",
  "url": "..."
}

Docker cleanup

Sent when a Docker cleanup job completes successfully.

{
  "success": true,
  "event": "docker_cleanup_success",
  "message": "Docker cleanup job succeeded",
  "server_name": "...",
  "server_uuid": "...",
  "cleanup_message": "...",
  "url": "..."
}

Server events

Sent when a previously unreachable server becomes reachable again.

{
  "success": true,
  "event": "server_reachable",
  "message": "Server revived",
  "server_name": "...",
  "server_uuid": "...",
  "url": "..."
}

Container events

Sent when a container stops unexpectedly (not via a manual stop action).

{
  "success": false,
  "event": "container_stopped",
  "message": "Resource stopped unexpectedly",
  "container_name": "...",
  "server_name": "...",
  "server_uuid": "...",
  "url": "..."
}

Test event

`test`

Sent when you click Send Test Notification in the Coolify dashboard.

{
  "success": true,
  "event": "test",
  "message": "This is a test webhook notification from Coolify.",
  "url": "..."
}

On this page