Some of the most useful and used triggers for our webhooks are those revolving around records creation/update/deletion, and when it comes to a "record update" event, it is very common the need to know exactly what has changed. So far, it was not that easy to get that information.

Well, now it is! For "record update" events, the webhook payload now presents the record data both before the update operation (previous_entity) and after (entity), making diffs extremely easy on your end.

Integrations/automations like "only do X if the title has changed" are like 1000% faster to develop:

1
{
2
  "environment": "foo-bar",
3
  "entity_type": "item",
4
  "event_type": "update",
5
  "entity": {
6
    "id": "39830648",
7
    "type": "item",
8
    "attributes": {
9
      "name": "Mark Smith",
10
    },
11
    "relationships": { ... },
12
    "meta": { ... }
13
  },
14
  "previous_entity": {
15
    "id": "39830648",
16
    "type": "item",
17
    "attributes": {
18
      "name": "John Smith",
19
    },
20
    "relationships": { ... },
21
    "meta": { ... }
22
  }
23
}