> ## 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.

# Handling Insight Calls to Action

> Learn what an insight's call to action (CTA) does, which insights send users to your own banking experience, and what to have in place before you enable them.

Many insights include a call to action that prompts the user to do something next, like review a transaction or move money to savings. Some CTAs require no work from you. Others send the user to part of your digital banking experience, such as your transfer flow, which must exist before you enable the insight.

> [!NOTE]
>
> If you're a developer looking for implementation details, refer to [Widget Events](https://docs.mx.com/products/experience/insights/integration-guides/widget-events.md#call-to-action-events).

## Types of CTAs

An insight in the Insights Widget can include up to three kinds of actions. Not every insight uses all three.

| Action | Where It Appears | Example |
| :- | :- | :- |
| Description link | A link at the end of the insight's description. | **View transactions** |
| Primary button | A button below the insight's description. | **Transfer funds** |
| Secondary button | A text link below the primary button. | **Edit alert settings** |

![Low Account Balance insight showing a description link, a CTA button, and a supporting action, with arrows to the screens each one opens](https://mintcdn.com/mx-7a01b258/2CWOnx7baIckmnqs/images/experience/insights/LowAccountBalance.png?fit=max\&auto=format\&n=2CWOnx7baIckmnqs\&q=85\&s=764248c139840f90ea84a7d21231c0c5)

## Where CTAs Send Users

Some images in the Insights Library label where each CTA goes. For example, the [Emergency Fund Withdrawal](https://docs.mx.com/products/experience/insights/library/save.md#emergency-fund-withdrawal) image shows that **Create transfer** redirects the user to create a transfer, while **View transactions** opens inside the widget.

Each CTA does one of two things:

* **Opens something inside the widget.** For example, **View transactions** opens a list of the related transactions. MX handles these CTAs for you.
* **Sends the user outside the widget.** For example, **Transfer funds** takes the user to your transfer flow. MX can't handle these, so your developers connect the CTA to the right place in your app or website.

## CTAs You Must Handle

These insights have CTAs that send users outside the widget. Before you enable them, confirm your digital banking experience meets each requirement.

Some insights show a different CTA depending on the user's situation. Support every CTA for an insight you enable.

Here's what each requirement means:

* **Funds transfer flow:** A place where users move money between their accounts.
* **Savings account opening:** A way for users to open a savings account.
* **Direct deposit integration:** A way for users to have their paycheck deposited into an account they hold with you.
* **Emergency savings view:** A page with the [Goals Widget](https://docs.mx.com/products/experience/pfm/widget-overviews/goals-widget.md), or another place where users can view their emergency savings.
* **Spending Plan Widget:** A page with the [Spending Plan Widget](https://docs.mx.com/products/experience/pfm/legacy-widget-overviews/spending-plan.md).

| Insight | CTA | Requirement |
| :- | :- | :- |
| [Designate Emergency Savings Account](https://docs.mx.com/products/experience/insights/library/save.md#designate-emergency-savings-account) | **Open Savings Account** | Savings account opening |
| [Emergency Fund Withdrawal](https://docs.mx.com/products/experience/insights/library/save.md#emergency-fund-withdrawal) | **Create transfer** (if funds transfers are enabled for you), or **View my emergency savings** (if they're disabled) | Funds transfer flow or emergency savings view |
| [Low Account Balance](https://docs.mx.com/products/experience/insights/library/spend.md#low-account-balance) | **Transfer funds** | Funds transfer flow |
| [Monthly Emergency Fund Review](https://docs.mx.com/products/experience/insights/library/save.md#monthly-emergency-fund-review) | **Create transfer**, **View my emergency savings**, **Create new goal** | Funds transfer flow and emergency savings view |
| [Monthly Obligations Status](https://docs.mx.com/products/experience/insights/library/spend.md#monthly-obligations-status) | **Make a transfer** (only when the user is off track) | Funds transfer flow |
| [Replenish Savings](https://docs.mx.com/products/experience/insights/library/save.md#replenish-savings) | **Create transfer** | Funds transfer flow |
| [Save an Extra \$100](https://docs.mx.com/products/experience/insights/library/save.md#save-an-extra-\$100) | **Make A Transfer** | Funds transfer flow |
| [Savings Account Deposit](https://docs.mx.com/products/experience/insights/library/save.md#savings-account-deposit) | **View my emergency savings**, **Start saving for emergencies** | Emergency savings view |
| [Savings Milestone Emergency Fund](https://docs.mx.com/products/experience/insights/library/save.md#savings-milestone-emergency-fund) | **View my emergency savings** | Emergency savings view |
| [Savings Opportunity V2](https://docs.mx.com/products/experience/insights/library/save.md#savings-opportunity-v2) | **Transfer funds**, **Open savings account** | Funds transfer flow and savings account opening |
| [Set Up Direct Deposit](https://docs.mx.com/products/experience/insights/library/spend.md#set-up-direct-deposit) | **Set up direct deposit** | Direct deposit integration |
| [Spending Plan Created](https://docs.mx.com/products/experience/insights/library/plan.md#spending-plan-created) | **Start Spending Plan**, **Visit Spending Plan** | Spending Plan Widget |
| [Switch Direct Deposit](https://docs.mx.com/products/experience/insights/library/spend.md#switch-direct-deposit) | **Switch direct deposit** | Direct deposit integration |
| [Transparent Overdraft](https://docs.mx.com/products/experience/insights/library/spend.md#transparent-overdraft) | **Transfer funds** | Funds transfer flow |
| [Unified Deposit Emergency Fund](https://docs.mx.com/products/experience/insights/library/save.md#unified-deposit-emergency-fund) | **Start saving for emergencies**, **Transfer funds**, **View my emergency savings** | Funds transfer flow and emergency savings view |
| [Weekly No Spend Days](https://docs.mx.com/products/experience/insights/library/spend.md#weekly-no-spend-days) | **View more** | Spending Plan Widget |

## CTAs in Your Own UI

If you [build your own insights UI](https://docs.mx.com/products/experience/insights/integration-guides/insights-api-guide.md) with the Platform API instead of our widgets, you decide what every CTA does, including the ones MX normally handles inside the widget. See [Actionable Insights](https://docs.mx.com/products/experience/insights/integration-guides/insights-api-guide.md#actionable-insights) for guidance.

## CTAs on Custom Insights

When you [create a custom insight](https://docs.mx.com/products/experience/insights.md#create-custom-insights), you define its CTAs. Give your MX representative:

* The text of the CTA buttons, which appear at the bottom of the insight.
* The text of the CTA link, which appears as part of the description.
* The name of the event triggered when the user selects the CTA.

## Measuring CTA Engagement

MX records when a user selects an insight's CTA, enabling you to track which insights lead users to act. Retrieve this data with the Platform API [Read Insight](https://docs.mx.com/api-reference/platform-api/v20260929/reference/insights/read-insight.md) endpoint.
