Notifications Overview
note
You can only use notifications endpoints if you’re using the MX mobile application.
All notifications created through the API will be of notification type API_NOTIFICATION, channel PUSH, and will not be associated to an entity. No other channels are supported.
The read and list endpoints can return any notification associated with the user, including notifications created by MX for other channels besides PUSH.
Notification Fields
| Field name | Data type | Description |
|---|---|---|
channel | integer | The way the notification will be delivered to the user. See notification channel for more information. |
content | string | The main body of the notification text sent to the user. |
created_at | string | Date the notification was created, as provided by our data feed. Represented in ISO 8601 format (e.g. 2015-04-13T12:01:23-00:00). |
deep_link_guid | string | The unique identifier for objects that directly trigger a notification. EX: TRANSACTION_FEE_CHARGE and TRANSACTION_EXPENSE_LARGE notification types will have a transaction guid in this field. |
delivered_at | string | Date and time the notification was delivered, represented in ISO 8601 format with timestamp (e.g. 2015-04-13T12:01:23-00:00). |
entity_guid | string | The unique identifier of the entity that the notification is attached to. |
guid | string | Unique identifier for the notification. Defined by MX. |
has_been_delivered | boolean | If the notification has been delivered to the user, this field will be true. Otherwise, this field will be false. |
has_been_viewed | boolean | If the notification has been viewed, this field will be true. Otherwise, this field will be false. |
notification_type | integer | Specific type of notification being sent. See notification types for more information. |
subject | string | The notification summary text. Usually the same text used for “in-app” or SMS notifications. |
threshold | integer | The amount that needs to be succeeded before the user receives the notification. |
Notification Channels
| Channel | Definition |
|---|---|
| 1 | |
| 2 | PUSH |
| 3 | SMS |
| 4 | IN_APP |
Notification Types
| Notification type | Definition |
|---|---|
| 1 | BUDGET_EXCEEDED |
| 2 | BUDGET_OFF_TARGET |
| 3 | DEBT_PAYMENT_REMINDER |
| 4 | GUIDE_ME_STEP_COMPLETE |
| 5 | GUIDE_ME_OFF_TARGET |
| 6 | ACCOUNT_BALANCE_LOW |
| 7 | ACCOUNT_DEPOSIT_LARGE |
| 8 | TRANSACTION_EXPENSE_LARGE |
| 9 | TRANSACTION_FEE_CHARGE |
| 10 | SYSTEM_NOTIFICATION |
| 11 | API_NOTIFICATION |
| 12 | USER_SUMMARY |
| 13 | OFFER |
| 14 | PASSWORD_RESET_TOKEN |
| 15 | PASSWORD_CHANGED |
| 16 | EMAIL_VERIFICATION |
| 17 | EMAIL_VERIFIED |
| 18 | WELCOME_NEW_USER |
| 19 | DEVICE_CREATED |
| 20 | DEVICE_DELETED |
| 21 | SMS_VERIFICATION |
| 22 | ACCOUNT_NEARING_ZERO |
| 23 | TRANSACTION_IS_INTERNATIONAL |
| 24 | INVALID_CONTACT_INFORMATION |
| 25 | GOAL_PROGRESS |
| 26 | CREATE_GOAL |
| 27 | FORGOT_USERNAME_REMINDER |
| 28 | SMS_WELCOME_MESSAGE |
| 29 | DUPLICATE_PAYMENT |