Organization events

This page documents the webhook events related to organization operations in Scalekit.

---

Organization events

organization.created

This webhook is triggered when a new organization is created. The event type is organization.created

organization.created

{
  "environment_id": "env_1234567890",
  "id": "evt_1234567890",
  "object": "Organization",
  "occurred_at": "2024-01-15T10:30:00.123456789Z",
  "organization_id": "org_1234567890",
  "spec_version": "1",
  "type": "organization.created",
  "data": {
    "external_id": "org_external_123",
    "id": "org_1234567890",
    "metadata": null,
    "settings": {
      "features": [
        {
          "enabled": true,
          "name": "sso"
        },
        {
          "enabled": false,
          "name": "dir_sync"
        }
      ]
    }
  }
}

Field	Type	Description
id	string	Unique identifier for the organization
external_id	string | null	External identifier for the organization, if provided
metadata	object | null	Additional metadata associated with the organization
settings	object | null	Organization settings including feature flags (sso, dir_sync)
settings.features	array	Array of feature objects with enabled status and name

organization.updated

This webhook is triggered when an organization is updated. The event type is organization.updated

organization.updated

{
  "environment_id": "env_1234567890",
  "id": "evt_2345678901",
  "object": "Organization",
  "occurred_at": "2024-01-15T10:35:00.123456789Z",
  "organization_id": "org_1234567890",
  "spec_version": "1",
  "type": "organization.updated",
  "data": {
    "external_id": "org_external_123",
    "id": "org_1234567890",
    "metadata": null,
    "settings": {
      "features": [
        {
          "enabled": true,
          "name": "sso"
        },
        {
          "enabled": false,
          "name": "dir_sync"
        }
      ]
    }
  }
}

Field	Type	Description
id	string	Unique identifier for the organization
external_id	string | null	External identifier for the organization, if provided
metadata	object | null	Additional metadata associated with the organization
settings	object | null	Organization settings including feature flags (sso, dir_sync)
settings.features	array	Array of feature objects with enabled status and name

organization.deleted

This webhook is triggered when an organization is deleted. The event type is organization.deleted

organization.deleted

{
  "environment_id": "env_1234567890",
  "id": "evt_3456789012",
  "object": "Organization",
  "occurred_at": "2024-01-15T10:40:00.123456789Z",
  "organization_id": "org_1234567890",
  "spec_version": "1",
  "type": "organization.deleted",
  "data": {
    "external_id": "org_external_123",
    "id": "org_1234567890",
    "metadata": null,
    "settings": {
      "features": [
        {
          "enabled": true,
          "name": "sso"
        },
        {
          "enabled": false,
          "name": "dir_sync"
        }
      ]
    }
  }
}

Field	Type	Description
id	string	Unique identifier for the organization
external_id	string | null	External identifier for the organization, if provided
metadata	object | null	Additional metadata associated with the organization
settings	object | null	Organization settings including feature flags (sso, dir_sync)
settings.features	array	Array of feature objects with enabled status and name