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": {
    "create_time": "2025-12-09T09:25:02.02Z",
    "display_name": "AcmeCorp",
    "external_id": "org_external_123",
    "id": "org_1234567890",
    "metadata": null,
    "region_code": "US",
    "update_time": "2025-12-09T09:25:02.025330364Z",
    "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
display_name	string | null	Name of the organization, if provided
region_code	string | null	Geographic region code for the organization (US, EU), currently limited to US
create_time	string	Timestamp of when the organization was created
update_time	string | null	Timestamp of when the organization was last updated
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": {
    "create_time": "2025-12-09T09:25:02.02Z",
    "display_name": "AcmeCorp",
    "external_id": "org_external_123",
    "id": "org_1234567890",
    "metadata": null,
    "region_code": "US",
    "update_time": "2025-12-09T09:25:02.025330364Z",
    "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
display_name	string | null	Name of the organization, if provided
region_code	string | null	Geographic region code for the organization (US, EU), currently limited to US
create_time	string	Timestamp of when the organization was created
update_time	string | null	Timestamp of when the organization was last updated
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": {
    "create_time": "2025-12-09T09:25:02.02Z",
    "deleted_at": "2025-12-09T10:25:45.337417Z",
    "display_name": "AcmeCorp",
    "external_id": "org_external_123",
    "id": "org_1234567890",
    "metadata": null,
    "region_code": "US",
    "update_time": "2025-12-09T09:25:02.025330364Z",
    "settings": {
10 collapsed lines
      "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
display_name	string | null	Name of the organization, if provided
region_code	string | null	Geographic region code for the organization (US, EU), currently limited to US
create_time	string	Timestamp of when the organization was created
deleted_at	string | null	Timestamp of when the organization was deleted
update_time	string | null	Timestamp of when the organization was last updated
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 domain events

organization.domain_created

This webhook is triggered when a domain is added to an organization. The event type is organization.domain_created

organization.domain_created

{
  "environment_id": "env_1234567890",
  "id": "evt_4567890123",
  "object": "OrganizationDomain",
  "occurred_at": "2024-01-15T11:00:00.123456789Z",
  "organization_id": "org_1234567890",
  "spec_version": "1",
  "type": "organization.domain_created",
  "data": {
    "id": "dom_1234567890",
    "domain": "acmecorp.com",
    "domain_type": "ORGANIZATION_DOMAIN",
    "verification_status": "VERIFIED",
    "verification_method": "ADMIN",
    "create_time": "2024-01-15T11:00:00.123456789Z",
    "update_time": "2024-01-15T11:00:00.123456789Z"
  }
}

Field	Type	Description
id	string	Unique identifier for the domain (dom_ prefix)
domain	string	The domain name that was added
domain_type	string	ORGANIZATION_DOMAIN for SSO/SCIM domains; ALLOWED_EMAIL_DOMAIN for auto-join domains
verification_status	string	Current status: PENDING, VERIFIED
verification_method	string	How the domain was verified: DNS (TXT record), ADMIN (added by the B2B app team), or NOT_APPLICABLE(for allowed email domains)
create_time	string	Timestamp of when the domain was added
update_time	string	Timestamp of the last status update

organization.domain_deleted

This webhook is triggered when a domain is removed from an organization. The event type is organization.domain_deleted

organization.domain_deleted

{
  "environment_id": "env_1234567890",
  "id": "evt_5678901234",
  "object": "OrganizationDomain",
  "occurred_at": "2024-01-15T12:00:00.123456789Z",
  "organization_id": "org_1234567890",
  "spec_version": "1",
  "type": "organization.domain_deleted",
  "data": {
    "id": "dom_1234567890",
    "domain": "acmecorp.com",
    "domain_type": "ORGANIZATION_DOMAIN",
    "verification_status": "VERIFIED",
    "verification_method": "DNS",
    "create_time": "2024-01-15T11:00:00.123456789Z",
    "update_time": "2024-01-15T12:00:00.123456789Z"
  }
}

Field	Type	Description
id	string	Unique identifier for the domain (dom_ prefix)
domain	string	The domain name that was removed
domain_type	string	ORGANIZATION_DOMAIN or ALLOWED_EMAIL_DOMAIN
verification_status	string	Status at the time of deletion
verification_method	string	DNS, ADMIN, or NOT_APPLICABLE
create_time	string	Timestamp of when the domain was originally added
update_time	string	Timestamp of the deletion

organization.domain_dns_verification_success

This webhook is triggered when Scalekit’s background DNS check successfully confirms that the organization has published the required TXT record for an organization domain. The event type is organization.domain_dns_verification_success

organization.domain_dns_verification_success

{
  "environment_id": "env_1234567890",
  "id": "evt_6789012345",
  "object": "OrganizationDomain",
  "occurred_at": "2024-01-15T13:00:00.123456789Z",
  "organization_id": "org_1234567890",
  "spec_version": "1",
  "type": "organization.domain_dns_verification_success",
  "data": {
    "id": "dom_1234567890",
    "domain": "acmecorp.com",
    "domain_type": "ORGANIZATION_DOMAIN",
    "verification_status": "VERIFIED",
    "verification_method": "DNS",
    "create_time": "2024-01-15T11:00:00.123456789Z",
    "update_time": "2024-01-15T13:00:00.123456789Z"
  }
}

Field	Type	Description
id	string	Unique identifier for the domain (dom_ prefix)
domain	string	The domain that was verified
domain_type	string	ORGANIZATION_DOMAIN
verification_status	string	VERIFIED
verification_method	string	DNS
create_time	string	Timestamp of when the domain was added
update_time	string	Timestamp when verification completed

organization.domain_dns_verification_failed

This webhook is triggered when the domain verification window expires without a successful DNS TXT record match for an organization domain. The event type is organization.domain_dns_verification_failed

organization.domain_dns_verification_failed

{
  "environment_id": "env_1234567890",
  "id": "evt_7890123456",
  "object": "OrganizationDomain",
  "occurred_at": "2024-01-17T11:00:00.123456789Z",
  "organization_id": "org_1234567890",
  "spec_version": "1",
  "type": "organization.domain_dns_verification_failed",
  "data": {
    "id": "dom_1234567890",
    "domain": "acmecorp.com",
    "domain_type": "ORGANIZATION_DOMAIN",
    "verification_status": "FAILED",
    "verification_method": "DNS",
    "create_time": "2024-01-15T11:00:00.123456789Z",
    "update_time": "2024-01-17T11:00:00.123456789Z"
  }
}

Field	Type	Description
id	string	Unique identifier for the domain (dom_ prefix)
domain	string	The domain that failed verification
domain_type	string	ORGANIZATION_DOMAIN
verification_status	string	FAILED
verification_method	string	DNS
create_time	string	Timestamp of when the domain was added
update_time	string	Timestamp when the failure was recorded