Account deleted - Plain Docs

This event is fired when an account is deleted. An account is the new name for a tenant: the company or organization your customers belong to. The payload contains previousAccount, the account as it was before it was deleted. This event was added in webhook version 2026-10-06. Targets on earlier versions don’t receive it.

Schema

View JSON Schema → Example:

{
  "timestamp": "2026-10-06T16:30:00.915Z",
  "workspaceId": "w_01GST0W989ZNAW53X6XYHAY87P",
  "payload": {
    "eventType": "account.account_deleted",
    "previousAccount": {
      "id": "te_01HD44FHDPG82VQ4QNHDR4N2T0",
      "name": "Acme Inc",
      "externalId": "acme-123",
      "source": "api",
      "primaryDomain": "acme.com",
      "alternateDomains": [
        "acme.io",
        "acme.co.uk"
      ],
      "isDomainAutoJoinEnabled": true,
      "createdAt": "2026-10-06T09:12:41.120Z",
      "createdBy": {
        "actorType": "user",
        "userId": "u_01H1V4NA10RMHWFBXB6A1ZBYRA"
      },
      "updatedAt": "2026-10-06T14:03:18.402Z",
      "updatedBy": {
        "actorType": "user",
        "userId": "u_01H1V4NA10RMHWFBXB6A1ZBYRA"
      }
    }
  },
  "id": "pEv_01HD4X9DWEMVR5KFYPT2GBH8XC",
  "webhookMetadata": {
    "webhookTargetId": "whTarget_01HD4400VTDJQ646V6RY37SR7K",
    "webhookTargetVersion": "2026-10-06",
    "webhookDeliveryAttemptId": "whAttempt_01HD4XK3NF7RXQZTM90WCE5YAC",
    "webhookDeliveryAttemptNumber": 1,
    "webhookDeliveryAttemptTimestamp": "2026-10-06T16:30:00.957Z"
  },
  "type": "account.account_deleted"
}

Using the Webhooks SDK

You can use the @team-plain/webhooks package to parse and verify this event with full type safety:

import { verifyPlainWebhook } from "@team-plain/webhooks";

const result = verifyPlainWebhook(rawBody, signature, secret);

if (result.error) {
  console.error(result.error.message);
} else {
  // result.data is fully typed with the event payload
  const event = result.data;
  console.log(event.eventType, event.payload);
}