Webhooks - Nubis Documentation

Event-Driven Infrastructure

Nubis Webhooks allow you to integrate your own internal systems with platform-wide events. When something happens in your Nubis account, we send an HTTP POST request to your designated URL.

Configuring a Webhook

Navigate to Developer Hub > Webhooks.
Click “Add Webhook”.
Target URL: The endpoint in your system that will receive the events.
Secret Key: A signing key used to verify the authenticity of the incoming requests.

Supported Events

You can subscribe to a wide range of platform events:

Compute: instance.started, instance.stopped, instance.resized.
Billing: invoice.generated, payment.failed, quota.limit_reached.
Security: user.logged_in, api_key.created, mfa.disabled.
Infrastructure: k8s.cluster_ready, database.backup_completed.

Payload Format

Webhooks are sent as JSON payloads.

{
  "event": "instance.resized",
  "timestamp": "2024-03-21T19:15:00Z",
  "resource_id": "v-12345",
  "data": {
    "prev_size": "s-1vcpu-2gb",
    "new_size": "s-2vcpu-4gb"
  }
}

Responding to Webhooks

Your endpoint should return a 200 OK status to acknowledge receipt. If your endpoint is down, Nubis will retry the delivery with exponential backoff for up to 24 hours.

​Event-Driven Infrastructure

​Configuring a Webhook

​Supported Events

​Payload Format

​Responding to Webhooks

Event-Driven Infrastructure

Configuring a Webhook

Supported Events

Payload Format

Responding to Webhooks