---
title: "Webhook receiver for fdx notifications"
method: POST
path: "/fdx/notifications"
tags: ["plaid"]
---

# Webhook receiver for fdx notifications

`POST /fdx/notifications`

A generic webhook receiver endpoint for FDX Event Notifications

## Request body

- FDXNotification — Provides the base fields of a notification. Clients will read the `type` property to determine the expected notification payload
  - `notificationId` string, required — Id of notification
  - `type` 'CONSENT_REVOKED' | 'CONSENT_UPDATED' | 'CUSTOM' | 'SERVICE' | 'BALANCE' | 'PLANNED_OUTAGE', required — Type of Notification
  - `sentOn` string, date-time, required — ISO 8601 date-time in format 'YYYY-MM-DDThh:mm:ss.nnn[Z|[+|-]hh:mm]' according to [IETF RFC3339](https://xml2rfc.tools.ietf.org/public/rfc/html/rfc3339.html#anchor14)
  - `category` 'SECURITY' | 'MAINTENANCE' | 'FRAUD' | 'CONSENT' | 'NEW_DATA', required — Category of Notification
  - `severity` 'EMERGENCY' | 'ALERT' | 'WARNING' | 'NOTICE' | 'INFO' — Severity level of notification
  - `priority` 'HIGH' | 'MEDIUM' | 'LOW' — Priority of notification
  - `publisher` FDXParty — FDX Participant - an entity or person that is a part of a FDX API transaction
    - `name` string, required — Human recognizable common name
    - `type` 'DATA_ACCESS_PLATFORM' | 'DATA_PROVIDER' | 'DATA_RECIPIENT' | 'INDIVIDUAL' | 'MERCHANT' | 'VENDOR', required — Identifies the type of a party
    - `homeUri` string, uri — URI for party, where an end user could learn more about the company or application involved in the data sharing chain
    - `logoUri` string, uri — URI for a logo asset to be displayed to the end user
    - `registry` 'FDX' | 'GLEIF' | 'ICANN' | 'PRIVATE' — The registry containing the party’s registration with name and id
    - `registeredEntityName` string — Registered name of party
    - `registeredEntityId` string — Registered id of party
  - `subscriber` FDXParty — FDX Participant - an entity or person that is a part of a FDX API transaction
    - `name` string, required — Human recognizable common name
    - `type` 'DATA_ACCESS_PLATFORM' | 'DATA_PROVIDER' | 'DATA_RECIPIENT' | 'INDIVIDUAL' | 'MERCHANT' | 'VENDOR', required — Identifies the type of a party
    - `homeUri` string, uri — URI for party, where an end user could learn more about the company or application involved in the data sharing chain
    - `logoUri` string, uri — URI for a logo asset to be displayed to the end user
    - `registry` 'FDX' | 'GLEIF' | 'ICANN' | 'PRIVATE' — The registry containing the party’s registration with name and id
    - `registeredEntityName` string — Registered name of party
    - `registeredEntityId` string — Registered id of party
  - `notificationPayload` FDXNotificationPayload, required — Custom key-value pairs payload for a notification
    - `id` string — ID for the origination entity related to the notification
    - `idType` 'ACCOUNT' | 'CUSTOMER' | 'PARTY' | 'MAINTENANCE' | 'CONSENT' — Type of entity causing origination of a notification
    - `customFields` FDXFiAttribute[]
      - `name` string, required — Name of attribute
      - `value` string, required — Value of attribute
  - `url` FDXHateoasLink — REST application constraint (Hypermedia As The Engine Of Application State)
    - `href` string, uri-reference, required — URL to invoke the action on the resource
    - `action` 'GET' | 'POST' | 'PATCH' | 'DELETE' | 'PUT' — HTTP Method to use for the request
    - `rel` string — Relation of this link to its containing entity, as defined by and with many example relation values at [IETF RFC5988](https://datatracker.ietf.org/doc/html/rfc5988)
    - `types` FDXContentTypes[] — Content-types that can be used in the Accept header

## Response `200`

OK

## Other responses

- `default` — Error response.

## Changes

- **2024-02-21** `5de70cc1e6ca` — 13 breaking, 5 warning, 12 info
  - removed the enum value `ACCOUNT_TAKEOVER` of the request property `type`
  - removed the enum value `ADDRESS_CHANGED` of the request property `type`
  - removed the enum value `CONSENT_EXPIRED` of the request property `type`
  - removed the enum value `CONSENT_GRANTED` of the request property `type`
  - …26 more

[Change history](https://skmtc.dev/plaid/apis/the-plaid-api/changes/fdx/notifications/post.md)

---

[API](https://skmtc.dev/plaid/apis/the-plaid-api.md) · [All operations](https://skmtc.dev/plaid/apis/the-plaid-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/plaid/the-plaid-api/revisions/a5b45bccb4e8/schema)