# FinGoal Fastlink API

**Canonical:** https://apis.io/apis/fingoal/fingoal-fastlink-api/  
**Provider:** FinGoal — https://apis.io/providers/fingoal/  
**Base URL:** https://findmoney.fingoal.com/v3  
**Documentation:** https://docs.fingoal.dev/

FinGoal Fastlink API is one of 7 APIs that [FinGoal](https://apis.io/providers/fingoal/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Fastlink. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, authentication docs, and rate-limit docs.

The Link Money API permits end users to link and get data from their bank accounts. But of course, that requires a front-end interface. That's where the Fastlink comes in. The Fastlink is an example of what we call a "Linking Widget" - a small application, usually embedded via iframe in another financial application, that allows end users to interact with an aggregation service - in this case, Yodlee's Fastlink. In this documentation `Fastlink` refers specifically to `Fastlink 4`, which is the most recent version of Yodlee's Fastlink widget. We do not support older versions of Fastlink, and urge all of our onboarding customers to upgrade to Fastlink 4. To open a frontend session with Link Money's Fastlink4, you must: - Have a client registered with the Link Money API - Have client credentials for the Link Money API - Have a single registered user with the Link Money API - Have a web application (or test web application) with HTML and JavaScript where the FL4 can be embedded. ### Step 1: Get an authentication token First, get an authentication token for Link Money. ```js const fetch = require('node-fetch'); // If using Node.js, ensure to install the 'node-fetch' package // Client credentials and other required information. We recommend storing these in a secure location, such as a password vault. const clientId = 'YOUR_CLIENT_ID'; const clientSecret = 'YOUR_CLIENT_SECRET'; // The URL to your authentication endpoint const tokenUrl = '{LINK_MONEY_BASE_URL}/oauth/token'; // Prepare the request body const requestBody = { clientId, clientSecret }; // Make the HTTP POST request to obtain the JWT try { const rawResponse = await fetch(tokenUrl, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: requestBody }); const data = await response.json(); const token = data.accessToken; // Use the access token for subsequent API requests that require authentication } catch(error) { console.error('Error fetching the access token:', error); } ``` ### Step 2: Get the Fastlink configuration With the `token` from the request, you can authorize a call to the Fastlink widget endpoint. ```js const fetch = require('node-fetch'); // If using Node.js, ensure to install the 'node-fetch' package const accessToken = "{YOUR_ACCESS_TOKEN}"; // see previous step. const getFastlinkConfigUrl = '{LINK_MONEY_BASE_URL}/yodlee/fastlink'; const login_name = `any_string_of_your_choice`; try { const rawResponse = await fetch(getFastlinkConfigUrl, { method: 'POST', headers: { 'Content-Type': 'application/json', 'Authorization': `Bearer ${accessToken}` }, body: { login_name } }); const data = await response.json(); const { fastlinkConfiguration } = data; const { accessToken, fastLinkURL, configName } = fastlinkConfiguration; // Use the accessToken, fastLinkURL, and configName to embed the Fastlink widget in your application } catch(error) { console.error('Error fetching the access token:', error); } ``` ### Step 3: Embed the Fastlink widget The fields provided above have supplied you with everything you need to open the Yodlee Fastlink widget in your application. To complete the integration, you will need to use the Yodlee Fastlink SDK along with the configuration provided above. ```html <!-- Mark Up --> <div id="container-fastlink"> <div style="text-align: center;"> <input type="submit" id="btn-fastlink" value="Link an Account"> </div> </div> <!-- Yodlee FL4 CDN --> <script type='text/javascript' src='https://cdn.yodlee.com/fastlink/v4/initialize.js'></script> <!-- Yodlee FL4 Config --> <script> // embed the code provided in the previous step here to receive... const { accessToken, fastLinkURL, configName } = fastlinkConfiguration; (function (window) { //Open FastLink const fastlinkBtn = document.getElementById('btn-fastlink'); fastlinkBtn.addEventListener('click', function() { window.fastlink.open({ fastLinkURL: fastLinkURL, // from step 2 accessToken: `Bearer ${accessToken}`, // from step 2; do not use the token from step 1 here. params: { configName : configName // from step 2 }, onSuccess: function (data) { // will be called on success. For list of possible message, refer to onSuccess(data) Method. console.log(data); }, onError: function (data) { // will be called on error. For list of possible message, refer to onError(data) Method. console.log(data); }, onClose: function (data) { // will be called called to close FastLink. For list of possible message, refer to onClose(data) Method. console.log(data); }, onEvent: function (data) { // will be called on intermittent status update. console.log(data); } }, 'container-fastlink'); }, false); }(window)); </script> ``` ### Step 4: Additional Configuration The Fastlink widget can be configured to meet your specific needs. For more information on configuration options, see the [Yodlee Fastlink 4 documentation](https://developer.envestnet.com/resources/yodlee/fastlink-4/docs/documentation). The Link Money API surfaces the variables required to open any instance of Fastlink 4. However, we do not currently surface any helper functions for customized instances of Fastlink4. However, we also do not restrict you from customizing the Fastlink widget to meet your needs. If you are opening the FL4 for a specific provider, simply alter the base configuration above as you normally would.

## Machine-readable artifacts (9)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/fingoal/refs/heads/main/openapi/fingoal-fastlink-api-openapi.yml
- **Documentation** — https://link-money-docs.fingoal.dev/
- **APIReference** — https://link-money-docs.fingoal.dev/
- **Webhooks** — https://raw.githubusercontent.com/api-evangelist/fingoal/refs/heads/main/asyncapi/fingoal-link-money-webhooks.yml
- **Components** — https://raw.githubusercontent.com/api-evangelist/fingoal/refs/heads/main/components/fingoal-components.yml
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/fingoal/refs/heads/main/authentication/fingoal-authentication.yml
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/fingoal/refs/heads/main/data-model/fingoal-data-model.yml
- **RateLimits** — https://raw.githubusercontent.com/api-evangelist/fingoal/refs/heads/main/rate-limits/fingoal-rate-limits.yml
- **SignUp** — https://fingoal.com/request-developer-account

## Other FinGoal APIs (6)

- [FinGoal Enrichment API](https://apis.io/apis/fingoal/fingoal-enrichment-api/)
- [FinGoal User Tagging API](https://apis.io/apis/fingoal/fingoal-user-tagging-api/)
- [FinGoal Webhook Configurations API](https://apis.io/apis/fingoal/fingoal-webhook-configurations-api/)
- [FinGoal Client Management API](https://apis.io/apis/fingoal/fingoal-client-management-api/)
- [FinGoal OAUTH API](https://apis.io/apis/fingoal/fingoal-oauth-api/)
- [FinGoal Webhooks API](https://apis.io/apis/fingoal/fingoal-webhooks-api/)

## Tags

Fastlink

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/fingoal/fingoal-fastlink-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/fingoal/.