Authenticate to Yodlee's API using your cobrand credentials to obtain a cobrand session token, then generate a user JWT by calling the user token endpoint with a unique loginName for each end user
Initialize FastLink 4.0 in an iframe by passing the user JWT and a FastLink URL configuration object that specifies the flow (Aggregation, Verification, or Edit), the selected providerAccountId for edit flows, and callback message event targets
Listen for postMessage events from the FastLink iframe; on the SUCCESS event, extract the providerAccountId and accountId values returned in the message payload
Call the Yodlee Accounts API with the providerAccountId to retrieve the linked account details and the Transactions API to fetch transaction history; handle ITEM_NOT_FOUND if the account data has not yet refreshed
Implement a refresh orchestration loop: check the providerAccount refreshInfo.status field — PARTIAL_SUCCESS or FAILED statuses indicate credential issues or MFA prompts that require re-launching FastLink in UPDATE mode
Store the providerAccountId and accountId, not user credentials; implement a scheduled refresh job that calls the provider account refresh endpoint and checks for data staleness beyond your SLA threshold
Known gotchas
Yodlee's cobrand session token has a short TTL and must be refreshed before expiry; building the cobrand token refresh into a middleware interceptor rather than handling it per-request avoids cascading failures
FastLink postMessage events are not guaranteed to fire if the user closes the iframe before completing the flow; implement a polling fallback on providerAccount status rather than relying solely on the success callback
Yodlee's production and developer environments use different base URLs and cobrand names; hardcoding either will cause authentication failures in the other environment
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp