Timeline entry changed - Plain Docs

This event is fired when an entry on a customer or thread timeline changes. changeType is ADDED, UPDATED or REMOVED; previousTimelineEntry is null on ADDED.

Schema

View JSON Schema → Example:

{
  "timestamp": "2023-11-02T14:25:42.570Z",
  "workspaceId": "w_01GST0W989ZNAW53X6XYHAY87P",
  "payload": {
    "eventType": "timeline.timeline_entry_changed",
    "previousTimelineEntry": null,
    "timelineEntry": {
      "id": "t_01HE86SXY5FCRG2M1X9ZVRX09Q",
      "customerId": "c_01HD44FHDPG82VQ4QNHDR4N2T0",
      "threadId": "th_01HD44FHMCDSSWE38N14FSYV6K",
      "timestamp": "2023-11-02T14:25:42.570Z",
      "actor": {
        "actorType": "user",
        "userId": "u_01H1V4NA10RMHWFBXB6A1ZBYRA"
      },
      "entry": {
        "entryType": "note",
        "noteId": "n_01HE86SXY54QYS46T9HZF218DQ",
        "text": "VIP customer",
        "markdown": "**VIP** customer"
      }
    },
    "changeType": "ADDED"
  },
  "id": "pEv_01HE86SY5A9KKTACZW3FGQJ0CS",
  "webhookMetadata": {
    "webhookTargetId": "whTarget_01HD4400VTDJQ646V6RY37SR7K",
    "webhookTargetVersion": "2026-09-18",
    "webhookDeliveryAttemptId": "whAttempt_01HE86V6GP2JZCQ3D6AXK81TWD",
    "webhookDeliveryAttemptNumber": 3,
    "webhookDeliveryAttemptTimestamp": "2023-11-02T14:26:23.894Z"
  },
  "type": "timeline.timeline_entry_changed"
}

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);
}