> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mx.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhooks Changelog

## 2025

<Update label="05/14/2025" tags={["Webhooks"]}>
  Added: Initial Data Ready webhook. Only applies if you're using Platform API v20250224.
</Update>

<Update label="01/31/2025" tags={["Webhooks"]}>
  Added: The `X-CALLBACK-PAYLOAD` header will appear in the Member and Member Data Updated webhooks if it was set in the Create/Update Member or Aggregate/Verify Member respectively. This is only for Platform API.
</Update>

## 2024

<Update label="11/01/2024" tags={["Webhooks"]}>
  Added: `use_cases` field to the Member webhook.
</Update>

## 2023

<Update label="11/28/2023" tags={["Webhooks"]}>
  Added: Spending Plan webhook.
</Update>

<Update label="11/28/2023" tags={["Webhooks"]}>
  Added: support for verification webhooks.
</Update>

<Update label="09/28/2023" tags={["Webhooks"]}>
  The `is_recurring` field should be ignored.
</Update>

<Update label="08/04/2023" tags={["Webhooks"]}>
  Added the `estimated_payment_due_at` field to account-related notification webhooks.
</Update>

## 2022

<Update label="10/17/2022" tags={["Webhooks"]}>
  Added the `job_guid`, `is_background`, and `user_id` fields to the `AGGREGATION` webhook payload.
</Update>

<Update label="10/06/2022" tags={["Webhooks"]}>
  Added `member_guid` to the payloads for transaction and account-related notification webhooks.
</Update>

<Update label="08/16/2022" tags={["Webhooks"]}>
  Added `member_guid` to the transactions webhook.
</Update>

<Update label="04/22/2022" tags={["Webhooks"]}>
  The table explaining member connection statuses was expanded to include more information as well as the `PENDING` status.
</Update>

<Update label="02/23/2022" tags={["Webhooks"]}>
  The `created_at` field was incorrectly shown as an ISO value in the example payload for beat webhooks. It has been corrected to a Unix timestamp.
</Update>

<Update label="02/08/2022" tags={["Webhooks"]}>
  The check\_number field was incorrectly documented as an integer. It has been corrected to a string.
</Update>

<Update label="01/19/2022" tags={["Webhooks"]}>
  The `is_oauth` field was added to member webhooks.
</Update>

<Update label="01/05/2022" tags={["Webhooks"]}>
  The beats webhook was deprecated.
</Update>

## 2021

<Update label="10/27/2021" tags={["Webhooks"]}>
  The payload for the `member_data_updated` webhook was corrected.
</Update>

<Update label="08/19/2021" tags={["Webhooks"]}>
  The definition of the `aggregated_at` field for members was updated to include more detail on when it is set and updated.
</Update>

<Update label="08/19/2021" tags={["Webhooks"]}>
  Added several more entries to the list of beat templates.
</Update>

<Update label="06/11/2021" tags={["Webhooks"]}>
  Clarified how partners should handle webhook requests and under what circumstances an error response should be returned to MX. Also clarified changes that can occur in webhook payloads.
</Update>

<Update label="06/02/2021" tags={["Webhooks"]}>
  Added definitions for the `is_recurring`, `is_subscription`, and `scheduled_payment_guid` fields for transaction webhooks.
</Update>

<Update label="06/02/2021" tags={["Webhooks"]}>
  Added documentation related to testing webhooks.
</Update>

<Update label="04/15/2021" tags={["Webhooks"]}>
  Added documentation on the is\_being\_aggregated field for member webhook payloads.
</Update>

<Update label="01/12/2021" tags={["Webhooks"]}>
  Added documentation on the `is_relevant` field for beats.
</Update>

## 2020

<Update label="06/22/2020" tags={["Webhooks"]}>
  The `user_agent` field was added to the response for analytics events, and the `user_agent_string` field was deprecated.
</Update>

<Update label="05/04/2020" tags={["Webhooks"]}>
  Corrected example payloads to show `null` where no value is available.
</Update>

<Update label="04/27/2020" tags={["Webhooks"]}>
  Two fields were added to the transactions webhook: `merchant_guid` and `merchant_location_guid`.
</Update>

<Update label="04/14/2020" tags={["Webhooks"]}>
  Added information on new account subtypes.
</Update>

<Update label="01/14/2020" tags={["Webhooks"]}>
  Add documentation on currency code for notification webhooks.
</Update>

<Update label="01/08/2020" tags={["Webhooks"]}>
  Add documentation for email/SMS verification tokens in webhook alerts.
</Update>

## 2019

<Update label="12/17/2019" tags={["Webhooks"]}>
  Add `client_id` and name to budget fields. Add `feed_is_international`, `is_international`, and `is_international_set_by` to transaction fields. Add `created_by` and correct `metatype` to `meta_type` in the goals fields.
</Update>

<Update label="09/17/2019" tags={["Webhooks"]}>
  Add documentation for notification webhooks.
</Update>

<Update label="08/20/2019" tags={["Webhooks"]}>
  Add `client_id` field to budgets and budget notifications payload.
</Update>

<Update label="03/13/2019" tags={["Webhooks"]}>
  Initial publication of documentation for Webhooks V1.
</Update>