Client Agent Linking: A Small Business Guide for ATO & Xero

You’ve hired a new bookkeeper or accountant. You’re ready to get BAS sorted, catch up the books, and stop chasing paperwork at night. Then the ATO asks you to complete client agent linking, and suddenly you’re bouncing between apps, logins, business records, and error messages that don’t explain much.

That frustration is normal. The process is meant to protect your business, but in practice it often feels like a test of patience more than a simple authority check. For small business owners already juggling payroll, invoices, staff, and cash flow, it can turn a straightforward onboarding task into a genuine delay.

The good news is that client agent linking becomes far easier when you separate it into two jobs. First, you complete the ATO side correctly. Second, you grant the right access inside your accounting software like Xero or MYOB. If you know where the hidden snags sit, you can save yourself a lot of back-and-forth.

What Is Client-Agent Linking and Why Does It Matter

You sign on a new bookkeeper, expect the BAS backlog to start moving, and then everything stops at one admin task. The ATO will not let your agent act for the business until the business authorises that relationship through client agent linking.

Client agent linking is the ATO’s security check for appointing a registered tax or BAS agent. It confirms that the person approving access is legitimately connected to the ABN and has the authority to nominate the agent. In practical terms, it is the approval step that lets your agent get access to the right ATO records without relying on old paper-style authority processes.

For small businesses, the hold-up is rarely the bookkeeping work itself. The time sink is the setup around it. If linking is not completed early, your accountant or bookkeeper can be ready to start and still be blocked from lodging, checking ATO balances, or acting on your behalf. That usually means more emails, more calls, and more unbillable chasing on both sides.

The process runs across myGovID, Relationship Authorisation Manager (RAM), and Online services for business (OSB). Each system handles a different part of the approval chain, which is why owners often feel like they are doing the same task three times. The ATO introduced client-agent linking as part of its tighter digital proof-of-identity controls for businesses dealing with registered agents through online services.

A quick video can help if you prefer seeing the flow before doing it yourself.

What each system actually does

Confusion usually starts when the wrong tool gets blamed for the problem.

Tool What it does Why it matters
myGovID Confirms your identity as a person You need a valid identity setup before you can act for the business
RAM Connects your identity to the business Your authority against the ABN needs to be recognised here
Online services for business Lets you nominate your agent This is the approval step your agent is waiting on

A problem in any one of those systems can stop the whole job. That is why this process catches out directors, office managers, and family-run businesses that assume "the accountant can sort it from their side".

Why small business owners get stuck

The usual issue is not reluctance. It is mismatch. A name variation, an outdated role, a missing authorisation in RAM, or business details that do not line up with the ABR can turn a ten-minute task into an afternoon of retries.

That is the practical reason this step deserves attention early. It protects your business, but it also protects your time when it is handled in the right order.

Practical rule: If client agent linking fails, check identity, authority, and ABN details before repeating the same step.

If you are appointing a new tax or BAS agent, treat client agent linking as part of onboarding, not as an afterthought. Done properly, it prevents delays, cuts down the back-and-forth, and gets your agent working on the tasks you are paying them for.

The Core Process Linking Your Business to Your Agent

You sit down to appoint your agent, thinking it will take ten minutes. An hour later, you are still bouncing between your phone, RAM, and Online services for business, and your accountant is waiting because they cannot act until you finish one approval. That is the true cost of client-agent linking for small businesses. It is usually not the task itself. It is the retries, the mismatched details, and the workday time it eats up when the steps are done out of order.

A person using a tablet screen displaying a software permissions interface to assign accounting system access.

The fastest way through is to treat it like a sequence with checkpoints. If one part is off, stop there and fix it before clicking through the rest. That saves far more time than repeating the same failed login three times and hoping for a different result.

Start with the right person and the right phone

Client-agent linking starts with the individual who has authority to act for the business. In a company, that is often a director or public officer. In a trust or other structure, it may be someone else. If the person is not recognised against the entity, the process stalls even if the login itself works.

myGovID also needs to be set up in that person’s legal name, using identity details that match their records. Small differences can cause trouble. A shortened first name, an old surname, or details spread across multiple devices can turn a simple setup into a support issue.

A practical approach is to check these points before logging in:

  • use the authorised person’s own myGovID
  • make sure their legal name matches their identity documents
  • use the same phone they used to set up myGovID, if possible
  • update any stale contact or identity details first

That sounds basic. It is also where many wasted afternoons begin.

Confirm the business relationship in RAM

Once myGovID is working properly, the next job is RAM. Through RAM, the individual’s identity is connected to the business entity.

For many owners, this is the point where the process stops making intuitive sense. They know they run the business, but the system still needs that authority to be correctly recorded and recognised. If RAM cannot confirm the relationship, Online services for business will not fix that problem later.

The usual flow is straightforward:

  1. sign in to RAM with myGovID
  2. select the entity or add it
  3. confirm the person’s role
  4. complete the link to the ABN

If that does not work, do not keep retrying blindly. Check whether the ABN details and authority records are current first. That is often the issue.

Get your details ready before the nomination step

Before opening Online services for business, gather the information you will need in one place. This is one of those small habits that saves real time, especially if you are doing it between calls, payroll, or customer work.

Have these ready:

Item Why you need it
Authorised person’s myGovID To sign in and verify identity
RAM access to the business To prove authority against the ABN
Correct business details To avoid mismatches with ABR and ATO records
Your agent’s Registered Agent Number To complete the nomination accurately

If you are also changing systems or onboarding a new advisor, it helps to review your broader setup at the same time. A quick comparison of accounting software options can help if this process is happening alongside a software change, because access problems often get mixed up with ATO authority problems.

Nominate your agent in Online services for business

After identity and authority are in place, complete the nomination in Online services for business. This is the step your tax agent or BAS agent is waiting on.

Use the agent’s Registered Agent Number carefully. A simple typo can send you looking for a technical problem that does not exist.

The practical sequence is:

  • sign in to Online services for business
  • locate the agent nomination function
  • enter the Registered Agent Number
  • submit the nomination
  • tell your agent straight away so they can accept it in time

Timing matters here. The nomination does not stay open indefinitely. If it expires before the agent acts, you may need to do it again. For a busy owner, that is exactly the sort of avoidable admin that ends up being done after hours.

Real-world workarounds when the process drags out

Small businesses lose unbillable time when someone tries from the wrong login. Then someone else has a go from another phone. Then the agent gets asked to “see what they can do from their end,” even though the hold-up is still with the business authority.

A better approach is to work through a short triage list:

  • If myGovID works but RAM does not, check authority and ABN records.
  • If RAM is fine but the nomination fails, recheck the Registered Agent Number and business details.
  • If multiple people are involved, choose one authorised person to handle the whole job.
  • If you stop halfway, come back with the same device and the same login.

That discipline matters. It reduces duplicated effort and cuts down the back-and-forth with your bookkeeper or accountant, who cannot complete your side of the process for you.

When to stop and verify instead of pushing on

Repeated errors usually point to one of four issues. Identity details do not match. Authority is not correctly recorded. Business records are out of date. Or the wrong task is being attempted altogether.

If you hit the same error more than once, pause and check the setup instead of trying random fixes. That is usually the point where a ten-minute job turns into a long support call.

Client-agent linking is an ATO authority task. It does not give your advisor access to your bookkeeping file, payroll platform, or document apps. Keeping that distinction clear saves a lot of confusion, especially when you are trying to get an agent started quickly.

Granting Access in Your Accounting Software

Many business owners lose time in this situation. They complete client agent linking and assume the bookkeeper can now see everything. That’s not how it works.

ATO authority and software access are separate jobs. One lets your agent deal with the ATO. The other lets them do the bookkeeping work inside your cloud file.

A person with green dreadlocks looking frustrated at a computer screen showing a program linking error message.

If you use cloud platforms and aren’t sure which one suits your business best, this comparison of accounting software options can help clarify the differences.

Xero access

In Xero, your bookkeeper or accountant usually needs advisor-level access or another permission set that allows the right work to be done. If access is too limited, they may be able to look at reports but not fix coding, reconcile transactions, or prepare BAS properly.

A practical Xero setup usually involves:

  1. Going to settings and then users
  2. Inviting the advisor by email
  3. Assigning the permission level that matches the work required
  4. Checking access to payroll, reports, bank accounts, and BAS features if relevant

If your business uses add-ons connected to Xero, don’t assume those permissions flow through automatically. They often need separate access.

MYOB access

MYOB can be slightly different depending on whether you’re using MYOB Business or AccountRight, but the principle is the same. You need to invite the right user and assign the right role.

Check for these points:

  • Role type: choose a role that allows bookkeeping and compliance tasks, not just basic viewing.
  • Payroll permission: if the business needs payroll support, confirm this is included.
  • Banking and reporting: the user should be able to reconcile, review reports, and assist with BAS-related work.

A restricted MYOB login can create the impression that the file is broken when the issue is solely missing permissions.

Hubdoc access

Hubdoc is often forgotten during onboarding, yet it can make a big difference to how quickly paperwork gets under control. If your business wants help with receipt capture, supplier bills, and document collection, your advisor may need access there too.

Typical Hubdoc tasks include:

  • Fetching statements and bills
  • Reviewing uploaded documents
  • Pushing documents into Xero
  • Keeping source records organised

If Hubdoc isn’t connected or your advisor can’t enter it, the bookkeeping process becomes more manual than it needs to be.

The fastest onboarding usually happens when the ATO authority and the software invites are done on the same day.

What your bookkeeper actually needs

Not every business needs the same access. A payroll-heavy trade business will need a different setup from a consultant with simple monthly reconciliations.

Here’s a useful perspective:

Task Likely software access needed
Bank reconciliation Transaction and bank feed access
BAS preparation GST coding, reports, and activity statement support
Payroll processing Payroll module access
Debtor and creditor management Sales, bills, and contact records
Cash flow reporting Financial reports and dashboard visibility

If you’re unsure, ask your advisor what level they need before sending the invite. It’s easier to get it right at the start than to fix permissions after work has already begun.

What not to do

Some owners react to uncertainty by giving full admin access everywhere. That can create its own risk. Give the access required for the agreed work, but do it deliberately.

Avoid these common missteps:

  • Using a generic staff login: this causes confusion and weakens accountability.
  • Inviting the wrong email address: a simple typo can delay setup.
  • Granting view-only access when you need active bookkeeping support: the job stalls.
  • Assuming one system enables the others: it doesn’t.

Client agent linking is only one half of access. Your accounting software is the other half, and both need to be cleanly set up before the actual work can start.

How to Fix Common Client-Agent Linking Errors

Friday afternoon is when this usually blows up. The BAS is due, your bookkeeper is waiting, and the ATO system says the person trying to link the business is not authorised. No work gets done, but the clock keeps running.

The official steps look tidy on paper. In practice, client-agent linking usually falls over because one of four things is wrong. The identity details do not match, the business authority is not recorded the way you expect, the nomination has expired, or an old agent setup is still sitting in the background.

A visual guide explaining how to troubleshoot and fix common client-agent linking errors with suggested solutions.

For smaller and family-run businesses, especially outside metro areas, this is a recurring admin drain. CPA Australia has raised concerns about myGovID and nomination delays affecting practices and clients, particularly during agent changes, as outlined in CPA Australia’s CAL commentary.

When myGovID won’t verify properly

If myGovID setup keeps failing, stop retrying blindly. Repeated attempts rarely fix the underlying issue and usually waste half an hour you cannot bill or get back.

Start with the basics:

  • Check your name exactly as recorded. Middle names, shortened names, and mismatched surnames can cause the verification to fail.
  • Make sure the right person is doing it. The office manager or spouse who handles admin is not always the person recognised as holding authority for the business.
  • Review the identity documents used. The details need to line up with what the system is checking.
  • Retry only after confirming those details.

A common small business problem is practical rather than technical. The person who knows the bookkeeping is often not the person formally tied to the ABN.

When RAM says you’re not authorised

This usually points to an authority issue, not a login issue. That distinction matters, because changing passwords will not fix business records.

Use the error message to narrow it down:

Error type What it usually means Best next step
Principal authority issue RAM cannot confirm you can act for the business Check the ABN and entity records are current
Business not available in RAM The relationship between you and the ABN is not linking properly Confirm the correct authorised person is trying to act
Stuck in a loop after login Identity is working, but authority is not resolving Stop retrying and verify the business records first

If the system says you are not authorised, treat that as a records problem until proven otherwise.

When the nomination expires

An expired nomination is simple to diagnose and annoying to fix. You usually need to create it again and let your agent know straight away so they can accept it within the allowed time.

Timing matters here. Do not lodge the nomination and assume your accountant or bookkeeper will spot it later. If they are in payroll week, month-end, or BAS week, that invite can sit untouched until it expires.

The practical workaround is straightforward. Set up the nomination when your agent is ready to action it, not days before.

When you’re changing agents

Agent changes often create the messiest delays because old access, old email addresses, and old assumptions all collide at once. Delays can hit hardest in this area, especially when one side thinks the handover is finished and the ATO records say otherwise.

Before you nominate the new agent:

  • Review current authorisations in RAM
  • Remove outdated relationships where required
  • Check the business contact details attached to the record
  • Confirm the new agent’s details carefully before submitting

This is one of those jobs that looks small and ends up chewing through a morning if it is done in the wrong order.

When the process keeps failing for no clear reason

Strip it back to the likely causes and test them one by one:

  • Business records do not match ABR details
  • The wrong individual is trying to act for the entity
  • The nomination has expired
  • A previous agent relationship is interfering with the changeover
  • Someone is confusing ATO linking with accounting software access

If it still fails, write down the exact step where it stops. “It doesn’t work” gives your advisor nothing useful to work with. “RAM accepts the login but fails when linking the ABN” is specific enough to diagnose.

That small bit of detail can save a lot of back-and-forth, and often gets you to the actual fix faster.

Your Essential Client-Agent Linking Checklist

The easiest way to reduce stress is to treat client agent linking like a pre-flight checklist. Gather what you need first, then work through it without jumping between systems randomly.

A visual checklist outlining the ten essential steps for successfully linking a client and an agent.

Before you log in

  • Confirm who should complete it
    The right person is someone recognised as having authority for the business.
    What you need: confidence that the person acting is the correct authority.

  • Prepare your myGovID
    Make sure it’s working before you open other systems.
    What you need: your phone, access to the app, and matching personal identity details.

  • Check your business records
    Small discrepancies can stop the process.
    What you need: current ABN-related business details and confidence they align with official records.

During the linking process

  • Open RAM first
    In RAM, you connect your identity to the business.
    What you need: active myGovID access.

  • Link yourself to the ABN
    If this step fails, don’t move on and hope OSB will fix it.
    What you need: the correct entity and the right authority.

  • Have your agent’s RAN ready
    You’ll need it when nominating your agent in Online services for business.
    What you need: the exact Registered Agent Number from your advisor.

  • Complete the nomination in OSB
    This is the step that authorises the relationship from your side.
    What you need: successful login and the correct agent details.

After the nomination

  • Tell your agent immediately
    Don’t assume they’ll somehow know the nomination is waiting.
    What you need: a quick email or phone call.

  • Grant software access separately
    Xero, MYOB, and Hubdoc are not covered by the ATO link.
    What you need: admin or owner access inside your accounting software.

  • Keep a note of what was done
    If there’s a delay later, you’ll want to know who completed each step and when.
    What you need: a simple record in your email, task system, or diary.

A short version to keep handy

Task Why it matters
myGovID ready Confirms personal identity
RAM link complete Connects you to the business
OSB nomination done Authorises your agent
RAN entered correctly Prevents avoidable delays
Software invite sent Lets the actual bookkeeping work begin

A checklist won’t remove every technical problem, but it does stop the avoidable ones.

The Strategic Payoff of a Secure Digital Handshake

Client agent linking feels like admin. It’s more than that. It’s the gate between “we’re ready to sort the books out” and “nothing can move yet”.

That delay has a real business cost. Chartered Accountants ANZ told the ATO that the process is directly “financially impacting the operation of accounting practices”, and that its “cumbersome” nature creates onboarding delays exceeding one week and unbillable time while agents help clients through the system, as reported by Accountants Daily on the CA ANZ submission. For a small business owner, that often shows up as delayed BAS work, postponed cleanup, and extra admin at exactly the wrong time.

Why getting it done properly matters

When access is delayed, your advisor can’t do the work you hired them to do. They may be ready to review GST coding, check payroll setup, chase missing transactions, or prepare compliance work, but the process is stuck at the front gate.

That has a flow-on effect across the business:

  • BAS and IAS timelines tighten
  • Bookkeeping cleanup gets pushed back
  • Cash flow reporting arrives later than it should
  • Questions about payroll, debtors, and creditors stay unresolved longer

For businesses already running close to the line, time lost in setup can turn into decision-making blind spots.

Why the security side still matters

Even with all its clunky parts, the purpose behind client agent linking makes sense. Sensitive tax and business data should not be easy for the wrong person to access.

That matters most when:

  • A business is changing advisors
  • Authority sits with several family members or directors
  • Records and logins have become messy over time
  • The business has grown faster than its admin processes

The process can be frustrating and still be necessary. Both can be true.

Good bookkeeping starts with good access. If access is shaky, every downstream task becomes slower, riskier, or both.

The business benefit isn’t just compliance

Once the right authority is in place and the software access is sorted, your advisor can stop chasing logins and start doing useful work. That’s where the value shifts.

Instead of spending time on setup friction, they can focus on:

Priority area What becomes easier
BAS support Reviewing records and preparing lodgements on time
Cash flow visibility Producing clearer reporting and identifying pressure points
Payroll support Checking setup and handling ongoing obligations
Catch-up bookkeeping Cleaning up overdue periods faster
Debt and bill management Seeing the full picture sooner

If you’re weighing up whether the hassle is worth it, the answer is yes. Not because the process is elegant. Because once it’s done, your outsourced bookkeeping support can begin without the stop-start delays that waste everyone’s time.

A business runs better when the books are current, the ATO access is secure, and the right advisor can step in when needed. Client agent linking is one of those tasks that feels small while you’re avoiding it and feels important the moment something stalls.


If client agent linking has turned into a roadblock, Ideal Calculations can help you work through the practical steps and get your bookkeeping setup moving again. Whether you need a fresh start, catch-up support, or a bookkeeping health check, getting the access side right early will save time, reduce stress, and help keep your business compliant.

Scroll to Top