Sign in with Xero

Context and Why This Exists

Most StructureGram users already have a Xero login. Sign in with Xero lets you use that login here, so you don't need to remember another password — and so you can rely on the security controls (including two-factor authentication) you've already set up in Xero.

This is a separate feature from connecting Structuregram to your Xero Practice Manager (XPM) data. Signing in with Xero only proves who you are; it does not grant Structuregram access to any of your Xero accounting or XPM data. If you later want to import your XPM client groups, you'll still need to set up that connection separately under Account → Integrations.

What the Feature Does

The "Continue with Xero" button on the login and sign-up screens runs a standard Xero sign-in flow, then signs you into Structuregram as the matching user.

Sign-up: if no Structuregram account exists yet for your Xero email, one is created automatically using the name and email Xero supplies. You're taken straight into the onboarding flow to set up (or join) your firm's organisation.
Sign-in: if a Structuregram account already exists for that email (whether it was created with email/password, Google, Microsoft, or Xero), Xero sign-in takes you into that same account. No duplicate.
Linking is silent and email-based. You can sign in with whichever method you used first, or any of the others — they all share one account because they share your email address.

You can see the full list of methods you can sign in with on Account → Security under "Sign-in methods."

How to Use It

Sign up

Go to the sign-up page.
Click Sign up with Xero.
Sign in to Xero in the new tab (or, if you're already signed in, you may go straight through).
Approve the request to share your name and email with Structuregram. This is the only data Structuregram receives from this flow.
You'll land in Structuregram, ready to set up your organisation.

Log in

Go to the log-in page.
Click Log in with Xero.
Approve the share-name-and-email prompt if Xero asks (it usually only asks the first time on each device).
You'll be taken to your usual landing page (the Groups list).

The most recently used sign-in method is marked Last used on the log-in screen so you can find it quickly next time.

Edge Cases and Expected Behaviour

You already have a Google or Microsoft account on the same email. That's fine — Sign in with Xero will log you into the same Structuregram account. Your existing profile name isn't overwritten by what Xero supplies; only blank fields are filled in.
Two-factor authentication. Structuregram inherits the security of your Xero login: if your Xero account has 2FA on (it should), that step happens inside Xero. If you have Structuregram's MFA enrolled separately, you'll still be prompted to enter your 6-digit code after signing in with Xero — the same as for any other sign-in method.
First-time vs returning Xero sign-in. The very first time you use Sign in with Xero on a device, Xero will show its consent screen ("share your name and email with Structuregram"). After that, signing in is usually one click.
Signing in vs connecting XPM. Signing in with Xero is independent of the XPM connection. Signing in does not connect your XPM data; connecting XPM does not change how you sign in.

Troubleshooting (Q&A)

Q: I clicked "Log in with Xero" and was sent back to the log-in page with an error. A: Most often this means the consent prompt was cancelled or a security check failed (e.g. you took longer than 10 minutes between clicking the button and finishing the Xero step). Try again in a single browser tab.

Q: It signed me into a different account than I expected. A: Sign in with Xero takes you to the Structuregram account that has the same email address as your Xero login. If that's not the account you wanted, either:

Sign out and use the original method (e.g. email/password), or
Sign into Xero with the matching email address first, then try again.

Q: Can I have two Structuregram accounts with the same Xero email? A: No. One email = one Structuregram account. This is intentional — it's why you can switch between Google, Microsoft, Xero or email/password without ever ending up with duplicate accounts.

Q: Does this give Structuregram access to my Xero data? A: No. Sign in with Xero only shares your name and email. To let Structuregram read your XPM client groups, you need to separately connect XPM on the Account → Integrations page.

Q: How do I remove Sign in with Xero from my account? A: There's no per-method unlink in v1 — all the methods on your email share one account. If you want to stop using Xero sign-in, just use a different method (e.g. email/password) instead.

Best Practice

Use the same email everywhere. Sign-in linking is keyed to your verified email address, so using a different email in Xero than you set up Structuregram with will create a separate account.
Keep two-factor on, in Xero. Signing in with Xero is only as strong as your Xero login. If your firm hasn't enabled 2FA in Xero yet, do it.

Help & Documentation