Integration basics
Do I need to install an npm package?
Do I need to install an npm package?
nsdk-loader.js, render a host container, and provide a short-lived Embed Token from your backend.Which frameworks are supported?
Which frameworks are supported?
Can I embed multiple widgets on one page?
Can I embed multiple widgets on one page?
What browsers are supported?
What browsers are supported?
Authentication
Will upgrading to v1.9.0 require a fresh sign-in?
Will upgrading to v1.9.0 require a fresh sign-in?
Can users view and end other sign-in sessions?
Can users view and end other sign-in sessions?
How long should the Embed Token live?
How long should the Embed Token live?
iat and exp expressed in Unix seconds.Should I store the Embed Token in the browser?
Should I store the Embed Token in the browser?
What happens when the Embed Token expires?
What happens when the Embed Token expires?
What makes a token valid?
What makes a token valid?
aud = nsdk-embed and the required claims: iss, sub, aud, iat, exp, and jti. Include nsdk.user.name and nsdk.user.email so the session has the expected user context.When should the frontend fetch the Embed Token?
When should the frontend fetch the Embed Token?
Embedding runtime
Should I use declarative or imperative boot?
Should I use declarative or imperative boot?
How does the SDK handle SPA route changes?
How does the SDK handle SPA route changes?
Do I need to call NSDK('destroy') on unmount?
Do I need to call NSDK('destroy') on unmount?
Can I delay boot until the page is fully ready?
Can I delay boot until the page is fully ready?
NSDK('boot', ...).Security
Can I sign tokens in the frontend?
Can I sign tokens in the frontend?
What CSP headers do I need?
What CSP headers do I need?
script-src, frame-src, and any related network policies used by your environment.Is the Embed Token visible to end users?
Is the Embed Token visible to end users?
Can I include extra metadata in the token?
Can I include extra metadata in the token?
API & data
How do I know if my integration is working?
How do I know if my integration is working?
What does a 401 after successful embed mean?
What does a 401 after successful embed mean?
How often does data refresh?
How often does data refresh?
Can I test with mock tenant users first?
Can I test with mock tenant users first?
What must new users acknowledge during registration?
What must new users acknowledge during registration?
Can users connect more than one bank account?
Can users connect more than one bank account?
v1.5.12, users can connect multiple bank accounts when those accounts use the same currency. Additional accounts are added from Settings after the primary account has been connected.Can users connect bank accounts in different currencies?
Can users connect bank accounts in different currencies?
What happens after a user connects another bank account?
What happens after a user connects another bank account?
Can users connect Xero?
Can users connect Xero?
v1.5.14. In v1.8.7, provisioned users manage it alongside QuickBooks Online in Settings under Accounting connections, including organisation selection, readiness, the last complete update, refresh, reconnect and disconnect. Available product use depends on the supported source and enabled experience.Can users connect a point-of-sale system directly?
Can users connect a point-of-sale system directly?
Why does onboarding ask about the business and its goals?
Why does onboarding ask about the business and its goals?
Can users skip the business description after sharing a website?
Can users skip the business description after sharing a website?
How can users add business background after onboarding?
How can users add business background after onboarding?
Does saving business background immediately produce Growth ideas?
Does saving business background immediately produce Growth ideas?
How long does the first-use What can you do? offer remain?
How long does the first-use What can you do? offer remain?
Will every Coach answer show two follow-up suggestions?
Will every Coach answer show two follow-up suggestions?
Are Coach currency conversions bank exchange rates?
Are Coach currency conversions bank exchange rates?
How much bank transaction history can users connect?
How much bank transaction history can users connect?
v1.8.8, the SDK can request up to 749 days where the provider and consent permit it. Actual coverage depends on the bank and account, and banks with shorter history allowances can still be connected. Existing connections are not automatically backfilled; extending history can require reconnecting and renewing consent.Can users rate Money and Growth Actions?
Can users rate Money and Growth Actions?
v1.8.8, Action details include thumbs-up and thumbs-down controls with an optional note. Submit saves feedback, Cancel leaves saved feedback unchanged, and a saved rating can be edited. Ratings belong to the content reviewed and do not dismiss an Action, change its priority or start a Project.What changes when users expand Money in transactions?
What changes when users expand Money in transactions?
v1.8.9, View all and Show less change the visible row count while retaining consistent counterparty names and categories. Saved Money details remain readable, and expanded receipts use current records for the originating reporting period.Does Ask Coach retain the selected Income period?
Does Ask Coach retain the selected Income period?
v1.8.9, Ask Coach from Money in retains the selected dates, receipt totals and comparison in relevant follow-ups, including after reopening the conversation.How can users inspect a transaction category?
How can users inspect a transaction category?
Can users save a blank company name in Settings?
Can users save a blank company name in Settings?
Which characters can a company name contain?
Which characters can a company name contain?
Can users edit an invoice reminder in Coach?
Can users edit an invoice reminder in Coach?
Does copying an invoice reminder send it to the customer?
Does copying an invoice reminder send it to the customer?
What does Coach show while preparing an answer?
What does Coach show while preparing an answer?
v1.8.8, Coach shows the current step, elapsed time and an expandable list of completed and in-progress work. The steps reflect the question and the work being carried out. A greeting shows only its relevant steps.Can users retry a failed setup?
Can users retry a failed setup?
Does Ask Coach from a Money Action start a Project?
Does Ask Coach from a Money Action start a Project?
What is retained when a Money Project is reopened?
What is retained when a Money Project is reopened?
Can Coach remember business context in a new conversation?
Can Coach remember business context in a new conversation?
v1.8.7, relevant stable business context shared by the user can inform later conversations. Users can correct that context or ask Coach to forget it. Remembered background does not replace current financial records.What identity data is required before onboarding?
What identity data is required before onboarding?
What is Your journey?
What is Your journey?
Can users enter a sector that is not in a list?
Can users enter a sector that is not in a list?
Do Project task edits remain after signing in again?
Do Project task edits remain after signing in again?
How do Money actions affect journey progress?
How do Money actions affect journey progress?
Can Coach answer accounting questions from QuickBooks?
Can Coach answer accounting questions from QuickBooks?
v1.5.13, Coach can answer a first set of QuickBooks accounting questions when connected accounting data is available, including overdue invoices, customer balances, vendor bills, top vendors, and accounting expense categories.What happens when a user selects New in Coach?
What happens when a user selects New in Coach?
v1.8, selecting New can keep the current Daily Briefing visible above the clean conversation state. No empty chat session is created until the user sends a message or chooses an action that needs one.How do users ask Coach for help with the product?
How do users ask Coach for help with the product?
v1.8.5, users can select Help from the Coach menu. The composer shows a visible @help marker, and Coach answers from maintained guidance for the deployed product version while keeping the exchange in normal conversation history.Can Coach answer questions across longer financial periods?
Can Coach answer questions across longer financial periods?
v1.8.5, Coach can honour explicit periods across the available transaction history and can produce longer cash-planning scenarios when enough evidence is available. It states coverage limits, keeps observed and projected values separate, and labels longer forecasts as assumption-based estimates.What changed for Money recommendations in v1.8?
What changed for Money recommendations in v1.8?
What changed for Growth projects in v1.8?
What changed for Growth projects in v1.8?
Can users launch Coach reports and actions?
Can users launch Coach reports and actions?
Where does the first visit happen?
Where does the first visit happen?
How are Money recommendations grounded?
How are Money recommendations grounded?
Can Money ask follow-up questions before showing a recommendation?
Can Money ask follow-up questions before showing a recommendation?
v1.5.9, Money can ask targeted follow-up questions when transaction data alone cannot confirm eligibility or usage. The item is then resolved into a confirmed recommendation or dismissed with context.How are curated reports delivered?
How are curated reports delivered?
What changed for competitor intelligence?
What changed for competitor intelligence?
v1.5.14, competitor intelligence favours nearby competitors more directly, uses fallback discovery when local sources return no useful places, and avoids advice that conflicts with constraints the owner has already stated.Can users snooze insights instead of dismissing them?
Can users snooze insights instead of dismissing them?
v1.5.8, Money insights can be snoozed when they are relevant but not actionable today. Snoozed items are retained across refresh cycles and can be managed from a dedicated view.Why does Money use the latest available snapshot on first load?
Why does Money use the latest available snapshot on first load?
Can the SDK surface grants or tax-benefit opportunities?
Can the SDK surface grants or tax-benefit opportunities?
Partner customisation
Can a tenant opt out of partner product referrals?
Can a tenant opt out of partner product referrals?
v1.8.8, an explicit referral opt-out in the tenant’s existing configuration is respected across Coach, Money, Growth and Projects. It is managed by Narrative and the partner team, not through the end-user branding controls.Can the SDK use partner branding?
Can the SDK use partner branding?
Can the Coach tone match a partner brand?
Can the Coach tone match a partner brand?
v1.5.7 supports partner-specific coaching personality configuration so the assistant can better match a tenant’s preferred tone and vocabulary.Can partners use custom fonts?
Can partners use custom fonts?