Getting Set Up in Barnaby: Your Free AI Key, Your Bank and Your Calendar, Step by Step (2026)

What an API key is and how to get a free Gemini one, what Akahu is and how connecting your bank works (read-only, it can never move money), and getting your due dates into your own calendar.

Getting set up in Barnaby

Just signed in? Three things make Barnaby work for you: a free AI key, a connection to your bank, and a link that puts your due dates in your own calendar. This guide explains what each one is, in plain words, and walks you through it. Allow about 15 minutes.

What you’ll set up

Everything is in Settings: click the gear at the top right of any page. The three parts are separate, so you can do one now and the rest later.

  • An AI key (needed): Barnaby uses AI to sort your transactions, read statements and documents, and answer questions in Ask Barnaby.
  • Your bank (optional): transactions come in by themselves. Without it, you can upload statements from your bank’s website instead.
  • Your calendar (optional): rates, inspections, GST and provisional tax dates show up in Apple, Google or Outlook calendar.

1. What is an API key?

An API key is like a private password for apps. Instead of you typing into an AI chat yourself, it lets Barnaby send the AI a job, such as “which category is this transaction?”, using your own AI account. (API stands for application programming interface: the way one app talks to another.)

You get the key from the AI company and paste it into Barnaby once. Barnaby keeps it locked away and never shows it again. Because the account is yours, any cost goes straight to the AI company, not through Barnaby, and you can cancel the key at any time from their website.

Barnabyhas a job for the AIsends it with your keyYour AI accounte.g. Gemini (free)sends the answer backBarnabyshows you the answer
How your AI key is used

Which AI? Gemini, from Google, has a free tier that needs no card and is plenty for one household, so start there. Claude and OpenAI also work; they charge per use.

2. Get your free Gemini key

  1. In Barnaby, open Settings, then AI. In AI providers, click Get your free Gemini key. Google’s AI Studio opens in a new tab (aistudio.google.com/apikey).
  2. Sign in with any Google account.
  3. The first time, Google asks you to accept its terms, which include a tick box for developers. It’s fine to tick it: it’s the normal step for anyone getting a key, not just programmers.
  4. Click Create API key (new accounts may already have one listed), then copy it. It’s a long string of letters and numbers.

Treat the key like a password: don’t email it or post it anywhere. If you think someone else has it, delete it in AI Studio and make a new one. On the free tier, Google may use what’s sent to improve its models; its paid tier doesn’t.

3. Add it to Barnaby

Back in Settings, AI, paste the key into the Gemini (Google) row and click Save. The row then shows that a key is saved; the key itself is never shown again.

Underneath, Which AI runs each feature lets you choose. With only a Gemini key, leave it on Gemini. If you add more keys later, you can pick a different AI for some jobs.

4. What is Akahu?

Akahu is New Zealand’s open-banking service. It connects to the major NZ banks so apps you choose can see your transactions, without you handing those apps your bank password.

  • It’s read-only. Barnaby can see your accounts and transactions. It can never move money, make payments or change anything at your bank.
  • You log in to your bank on Akahu’s own secure page, never in Barnaby.
  • Akahu gives you two tokens. Like the AI key, they’re private passwords that let Barnaby read the transactions for the accounts you connected.
  • It’s free for a personal connection like this, and you can disconnect any time, in Barnaby or on Akahu’s website.
Your bankyou log in on Akahu’s pageshares transactionsAkahuread-only connectiontwo tokens let it readBarnabyreads transactions
How the bank connection works

Transactions sync in the background, about once a day. When you first connect, Akahu brings in up to the last year; for anything older, upload a statement.

5. Connect your bank

In Barnaby, open Settings, then Bank connection, and click Set up the connection. The same steps are listed there. They take about 10 minutes, mostly on Akahu’s website:

  1. Go to my.akahu.nz and create a free account (or log in).
  2. Click Developers in Akahu’s menu. Everything else happens on that page.
  3. Agree to Akahu’s Developer Terms and click Continue. (Again, it’s the normal step, not just for programmers.)
  4. Confirm who you are if asked: a one-time check, usually a photo of your driver licence or passport.
  5. Set up two-factor sign-in if asked: install a free authenticator app on your phone, scan the code Akahu shows and type in the 6-digit number. Keep the app; Akahu asks for a code each time you log in.
  6. Connect your bank accounts: search for your bank and log in on Akahu’s secure page. Connect every account you want in Barnaby: personal, each rental property’s, and your business account.
  7. Akahu then shows two values: an App ID Token and a User Access Token (the second appears once at least one account is connected).
  8. Back in Barnaby, copy both into the boxes, in the same order, and click Connect.

No Akahu? That’s fine. Each area’s Transactions page can take a statement file downloaded from your bank’s website instead.

One connection covers everything, so Barnaby needs to know which bank account belongs where. In each area’s settings (a property’s, your personal account’s or your business’s), open Bank accounts and pick the account it uses. Transactions from that account then land in the right place by themselves.

Haven’t added a property, personal account or business yet? Do that first; the Getting started box on Home has a link for each.

7. Your calendar

Barnaby knows your due dates: rates instalments, inspections, GST returns and provisional tax. To see them in your own calendar, open Settings, then Calendar, and click Create my calendar link.

  1. Copy the link and add it as a subscribed calendar: in Apple Calendar, File, New Calendar Subscription; in Google Calendar, Other calendars, From URL; in Outlook, Add calendar, Subscribe from web.
  2. The dates update by themselves when things change in Barnaby (Apple checks within a few hours, Google can take up to a day). Only dates and titles are shared, never amounts.
  3. Keep the link private, like a password. If you ever share it by mistake, click Make a new link and the old one stops working.

Prefer one-off reminders? The Add to calendar buttons next to each date do that instead.

8. What next

You’re set up. The Getting started box on Home ticks off each step as you go and shows what’s next, usually adding your first property, personal account or business and bringing in its transactions. Every section has its own step-by-step guide, linked from the blue i next to its heading, and you can ask Ask Barnaby about anything along the way.

Set up once, then it runs itself

A free AI key, your bank and your calendar, and Barnaby keeps your records and due dates in order.

Get started

Google AI Studio and Akahu are separate services with their own terms; their screens may change from the steps here. This is general information about using Barnaby, not financial advice.

Keep reading

All guides →

Barnaby does the sums

Stop doing tax maths by hand

Property, sole trader and household money in one place, with your GST, income tax, ACC and provisional tax worked out as you go.