Clerk organization webhooks: sync the org lifecycle with created, updated, deleted

TL;DR

organization.created, organization.updated, organization.deleted. On organization.updated: upsert name, slug, and metadata.

Steps

1. organization.created, organization.updated, organization.deleted. Same discipline as the user trio: subscribe to all three, one sync function, org id as the key.
2. On organization.created: create your local org record keyed by evt.data.id. Store name and slug. If you provision per-org resources (a workspace, a billing customer, default roles), provision them here, idempotently.
3. On organization.updated: upsert name, slug, and metadata. Slug changes break URLs; if you build org URLs from the slug, update your routes or redirects on this event.
4. On organization.deleted: tear down or archive the org's data in your app. Decide the policy once: hard delete, soft delete, or transfer ownership. Then apply it here, not ad hoc later.
5. Return 200.
6. Provisioning on created but never tearing down on deleted. Orphaned workspaces, billing customers, and storage buckets accumulate silently because the delete event was never subscribed. The trio rule from the user events applies verbatim.
7. - Org membership changes are separate events (organizationMembership.*). Do not conflate "org updated" with "someone joined."

• If you sync orgs, you almost certainly need the membership events too. An org record without its member list is half a sync.
• Test deletion with a throwaway org and a replay. Deletion paths are the least tested and the most destructive when wrong.

When to use

You are seeing this: Same discipline as the user trio: subscribe to all three, one sync function, org id as the key. Use this skill when you run into "Clerk organization webhooks: sync the org lifecycle with created, updated, deleted".

When not to use

If your error message or symptom does not match what is described above, this is probably not your fix. Search for your exact error text instead of forcing this one to fit.

Versions

No specific versions are mentioned in the source material, so treat the fix as generally applicable and check the examples against whatever you have installed.

Why this happens

The original report does not dig into a root cause. It documents the symptom and the fix that resolved it.

Clerk's event catalog (Dashboard → Webhooks → Event Catalog) lists organization.created, organization.updated, and organization.deleted. The syncing guide documents the webhook-driven sync pattern. Verified live at https://clerk.com/docs/guides/development/webhooks/syncing.