Webhooks

Webhooks are HTTP callbacks that Daytona sends to your specified endpoints when specific events occur. Think of them as "reverse API calls" - instead of your application asking Daytona for updates, Daytona proactively notifies your application when something important happens.

Webhooks enable powerful automation and integration scenarios:

• Real-time notifications: get instant alerts when sandboxes are created, started, or stopped
• Automated workflows: trigger deployment pipelines when snapshots are created
• Monitoring & analytics: track usage patterns and resource utilization across organizations
• Integration: connect Daytona with existing tools like Slack, Discord, or custom applications
• Audit & compliance: maintain detailed logs of all important changes

:::note Webhooks are available to organization admins and members with appropriate permissions. If you don't see Webhooks in Daytona Dashboard ↗, contact [email protected] to enable webhooks for your organization. :::

Accessing webhooks

Daytona provides a webhook management interface to access and manage webhook endpoints.

1. Navigate to Daytona Dashboard ↗
2. Click Webhooks in the sidebar

The webhooks management interface contains two tabs: Endpoints and Messages.

Endpoints

The endpoints tab lists all the webhook endpoints for the organization. Each endpoint has the following details:

• Name: the name of the webhook endpoint
• URL: the URL of the webhook endpoint
• Status: the status of the webhook endpoint
• Created: the timestamp when the webhook endpoint was created

Clicking on an endpoint opens the endpoint details page with additional endpoint configuration details: name, URL, events, status, delivery statistics, and event history.

Messages

The messages tab lists all the webhook messages for the organization. Each message has the following details:

• Message ID: the ID of the webhook message
• Event type: the event type of the webhook message
• Timestamp: the timestamp when the webhook message was created

Clicking on a message opens the message details dialog with additional message details: message ID, event type, timestamp, payload, and delivery attempts.

Delivery attempts are shown in a separate table with the following columns:

• Status: the status of the delivery attempt
• URL: the URL of the delivery attempt
• Timestamp: the timestamp when the delivery attempt was created

Expanding a delivery attempt displays additional delivery attempt details: status code, duration, trigger, endpoint ID, and response body.

Create webhook endpoints

Daytona provides a webhook management interface to create webhook endpoints.

1. Navigate to Daytona Dashboard ↗
2. Click Webhooks in the sidebar
3. Click Add Endpoint
4. Configure your endpoint:

• Endpoint name: a name for the endpoint
• Endpoint URL: HTTPS endpoint where you want to receive events
• Events: select which events to subscribe to

5. Click Create

Edit webhook endpoints

Daytona provides a webhook management interface to edit webhook endpoints.

1. Navigate to Daytona Dashboard ↗
2. Click Webhooks in the sidebar
3. Select a webhook endpoint from the Endpoints tab
4. Click the three dots menu (⋮) and select Edit
5. Update the endpoint details
6. Click Save

Delete webhook endpoints

Daytona provides a webhook management interface to delete webhook endpoints.

1. Navigate to Daytona Dashboard ↗
2. Click Webhooks in the sidebar
3. Select a webhook endpoint from the Endpoints tab
4. Click the three dots menu (⋮) and select Delete
5. Confirm the deletion

Webhook events

Daytona sends webhooks for lifecycle events across your infrastructure resources. You can subscribe to specific event types or receive all events and filter them in your application.

Sandbox events

Snapshot events

Volume events

Webhook payload format

All webhook payloads are JSON objects following a consistent format with common fields and event-specific data.

Common Fields:

sandbox.created

Sent when a new sandbox is created.

{
  "event": "sandbox.created",
  "timestamp": "2025-12-19T10:30:00.000Z",
  "id": "sandbox123",
  "organizationId": "org123",
  "state": "started",
  "sandboxClass": "container",
  "createdAt": "2025-12-19T10:30:00.000Z"
}

sandbox.state.updated

Sent when a sandbox's state changes.

{
  "event": "sandbox.state.updated",
  "timestamp": "2025-12-19T10:30:00.000Z",
  "id": "sandbox123",
  "organizationId": "org123",
  "oldState": "started",
  "newState": "stopped",
  "updatedAt": "2025-12-19T10:30:00.000Z"
}

snapshot.created

Sent when a new snapshot is created.

{
  "event": "snapshot.created",
  "timestamp": "2025-12-19T10:30:00.000Z",
  "id": "snapshot123",
  "name": "my-snapshot",
  "organizationId": "org123",
  "state": "active",
  "createdAt": "2025-12-19T10:30:00.000Z"
}

snapshot.state.updated

Sent when a snapshot's state changes.

{
  "event": "snapshot.state.updated",
  "timestamp": "2025-12-19T10:30:00.000Z",
  "id": "snapshot123",
  "name": "my-snapshot",
  "organizationId": "org123",
  "oldState": "building",
  "newState": "active",
  "updatedAt": "2025-12-19T10:30:00.000Z"
}

snapshot.removed

Sent when a snapshot is removed.

{
  "event": "snapshot.removed",
  "timestamp": "2025-12-19T10:30:00.000Z",
  "id": "snapshot123",
  "name": "my-snapshot",
  "organizationId": "org123",
  "removedAt": "2025-12-19T10:30:00.000Z"
}

volume.created

Sent when a new volume is created.

{
  "event": "volume.created",
  "timestamp": "2025-12-19T10:30:00.000Z",
  "id": "vol-12345678",
  "name": "my-volume",
  "organizationId": "org123",
  "state": "ready",
  "createdAt": "2025-12-19T10:30:00.000Z"
}

volume.state.updated

Sent when a volume's state changes.

{
  "event": "volume.state.updated",
  "timestamp": "2025-12-19T10:30:00.000Z",
  "id": "vol-12345678",
  "name": "my-volume",
  "organizationId": "org123",
  "oldState": "creating",
  "newState": "ready",
  "updatedAt": "2025-12-19T10:30:00.000Z"
}