Updated and previous attributes in webhook notifications

We’ve made an improvement to our webhooks, which enables your custom integration to track which attributes changed, and to see what the values were before.

Webhook notifications for the user.updated and group.updated topics now includes previous_attributes and updated_attributes keys in addition to the full object.

Here’s a partial example of what that looks like (this is what’s POSTed to your webhook subscription endpoint URL):

{
  "object": "webhook_notification",
  "data": {
    "object": {
      "id": "4738382",
      "object": "user",
      "attributes": {
        "email": "annabelle@example.com",
        "email_verified": true
      }
    },
    "previous_attributes": {
      "email_verified": false
    },
    "updated_attributes": {
      "email_verified": true
    }
  },
  "topic": "user.updated"
}

This is useful if you’d either like to know what an attribute was before it changed, or if you just want to know which attributes actually changed in this round. Read more in our Webhook subscriptions docs.