Macha

Gorgias Login Guide & Troubleshooting: Session Expired, SSO, and \"Can't Log In\"

Abbas, Customer Support & AI, Macha

Written by

Ankeet Guha, Co-founder & CTO, Macha

Reviewed by

Published July 12, 2026

Updated July 12, 2026

Most of the time, logging in to Gorgias is boring in the best way: you go to your workspace, type an email and password or click an SSO button, and you're in. This guide covers that happy path first, then the handful of errors that actually send ecommerce support teams looking for help — a session that keeps expiring, a cryptic "pk is not a valid integer" when you click a ticket link in Outlook, and an "unable to fetch" that turns out to be your own company firewall. Each one has a known cause and a fast fix, and none of them mean your account is broken. Work through the section that matches what you're seeing and you'll almost always be back in your queue within a minute or two.

Gorgias Login Guide & Troubleshooting: Session Expired, SSO, and \"Can't Log In\"

The normal way to sign in

Gorgias is multi-tenant, so there's no single universal login box — every account lives at its own subdomain. To sign in, go directly to yoursubdomain.gorgias.com, or start at gorgias.com/login and enter your workspace subdomain when prompted. From there you have two paths, both visible on the same screen:

  • Email and password — the standard agent login. Type the address you were invited with and your password.
  • Single Sign-On (SSO) — if your workspace has it enabled, click Sign in with Google or Sign in with Microsoft 365 and authenticate through your company identity provider instead of a Gorgias password. Per the Gorgias docs on logging in with SSO, if self-signup is turned on, new agents can even create their account through SSO on first click.
The Gorgias login screen for the Tanjorecollective workspace, with Google/Microsoft 365 SSO, email + password fields, and the 'Forgot password?' reset link — the sign-in and password-reset troubleshooting surface. Captured in a separate fresh browser context so the main session stayed intact.
The Gorgias login screen for the Tanjorecollective workspace, with Google/Microsoft 365 SSO, email + password fields, and the 'Forgot password?' reset link — the sign-in and password-reset troubleshooting surface. Captured in a separate fresh browser context so the main session stayed intact.

One thing worth knowing up front, because it causes a lot of confusion: if you sign in with Google or Microsoft SSO, you don't have a Gorgias password at all. So if you later try to "change your password" and can't find the option, that's expected — you'd first have to run the Forgot password flow to create one. Keep that in your back pocket; it explains a surprising share of "I can't log in" tickets.

Symptom → likely cause

Before the step-by-step, here's the fast lookup. Find your symptom, then jump to the matching fix below.

What you seeMost likely causeFix in short
"Your session has expired" on a loopSame account open in multiple tabsHard refresh; use one tab; clear cache
"pk is not a valid integer"A ticket link opened from Outlook/another app rewrote the URLCopy the raw URL into your browser bar
"Unable to fetch…"Company web-filtering/firewall blocking GorgiasAsk IT to whitelist gorgias.com
Password reset email never arrivesWrong subdomain, or it's in spamCheck spam; confirm the subdomain
No "change password" optionYou're an SSO user with no passwordRun Forgot password to set one
"Too many login attempts" on mobileCaptcha wall after repeated triesSign out/in on desktop to clear the captcha
2FA / authenticator won't accept a codeLost or reset authenticatorAsk an Admin to reset your 2FA token

The fixes, most common first

1. "Your session has expired" — you have Gorgias open in more than one tab

This is the single most common login complaint, and the cause is almost always mundane. Gorgias' own common account errors doc names it directly: the message "Your session has expired. You will be redirected to the login page in a few seconds" is typically triggered by multiple browser tabs pointed at the same account at once. The tabs fight over the session and one of them loses.

The fix, in order:

  1. Close every Gorgias tab but one, then do a hard refreshCmd+Shift+R on Mac, Ctrl+F5 on Windows — to force a clean reload rather than a cached one.
  2. If it recurs, clear your browser cache and cookies (and make sure the browser itself is up to date).
  3. Test in an incognito/private window or a different browser. If it behaves there but not in your normal window, you've confirmed it's stale cached data in your everyday profile — clear that browser and you're done.

Get in the habit of working Gorgias in a single tab and this one basically disappears.

2. "pk is not a valid integer" — you clicked a Gorgias link inside Outlook (or another app)

This error looks alarming and technical, but it's not your account — it's a URL that got mangled in transit. When you click a Gorgias link from inside a third-party app like Outlook, that app sometimes rewrites the target URL (for safe-link scanning), and the rewritten link no longer points at a valid ticket ID. Gorgias reads that as an invalid pk (its internal record key) and throws "pk is not a valid integer."

The fix is simple: copy the link text and paste it straight into your browser's address bar rather than clicking it. The un-rewritten URL resolves fine. If your team keeps hitting this from email notifications, that's the pattern to teach — click nothing, copy-paste instead.

3. "Unable to fetch…" — your own web filtering is blocking Gorgias

An "Unable to fetch…" error (often with parts of the helpdesk failing to load) usually isn't Gorgias at all. Per the same account-errors doc, it's commonly caused by third-party web-filtering software on your network blocking certain helpdesk features from loading. Because it's happening at the network layer, no amount of clearing cookies on your end will fix it.

The real fix lives with IT: ask them to whitelist all traffic from gorgias.com in your web filter, firewall, or corporate proxy. This is worth flagging early if the error shows up for everyone on your office network but not for someone on home wifi — that split is the giveaway that it's a filtering issue, not an account one.

4. Password reset email isn't arriving

To reset a password, go to yoursubdomain.gorgias.com/reset (or click Forgot password? on the login screen), enter your email, and submit. If the email doesn't show up, two causes dominate: it's sitting in your spam/junk folder, or you're on the wrong subdomain — the reset is scoped to the specific workspace, so a typo in the subdomain sends you nowhere. Confirm the subdomain, check spam, and try again. As a general first step for any login weirdness, Gorgias' login issues guide recommends clearing cache and cookies before you sign in with the new password.

5. "Too many login attempts" on mobile

Repeated failed attempts trip a captcha wall, and the mobile app doesn't always surface the captcha to solve it. The documented workaround: sign out and back in on desktop, where the captcha challenge appears, complete it, and then return to mobile. Clearing the captcha on the desktop side unblocks the account.

6. 2FA / authenticator lockout

If your authenticator app was reset, lost with a device, or you're not sure you ever set one up, you can't clear this yourself. An Admin on your account has to reset it: Settings → Users & Teams → Users → [your name] → Reset 2FA Token. After that you log in fresh and re-enroll. If you're the only admin and you're locked out, that's the one case where Gorgias support has to step in.

Honest caveats

A couple of things the trial or a basic plan won't show you, so you're not left hunting for a button that isn't there:

  • Custom / SAML SSO (using your own identity provider beyond Google and Microsoft 365) is a configuration item that depends on your plan and admin setup — the standard Google/Microsoft SSO buttons are what most workspaces see. Don't expect enterprise SAML to appear on a fresh trial workspace.
  • If none of the above applies and the helpdesk is genuinely unreachable, it may be a Gorgias-side outage rather than your login. Check the Gorgias status page — we walk through reading it in is Gorgias down?.

Where an AI layer quietly reduces the login noise

Here's a distinction worth drawing: everything above is about your agents getting into Gorgias. But a large share of the login-shaped work landing in an ecommerce queue is about your customers — "how do I reset my password," "I can't log in to my account," "where do I check my order status." Those aren't Gorgias errors at all; they're repetitive tickets that still consume an agent's time to answer.

That's the seam where an AI agent layer helps, and it's worth being clear about what it is: Macha is an AI agent for customer service that runs on top of the Gorgias you already use — it doesn't replace your help desk, it connects to it and reads and writes the same tickets your agents do. It can answer the routine account and order questions on meaning rather than keyword matching, so the volume behind "I can't log in" and "where's my order" thins out before a human ever opens it. For the fuller picture of how that works on Gorgias specifically, see Gorgias AI agent explained, or start with what Gorgias is if you're newer to the platform.

Because an agent acts on meaning, you can extend it too: a custom tool turns any REST API into an action the agent can call — looking up a customer's order or account status mid-conversation, something a canned reply can't do. Credits are charged per AI action rather than per resolution, and the specifics live on pricing.

FAQ

How do I log in to Gorgias? Go to your workspace URL — yoursubdomain.gorgias.com — or start at gorgias.com/login and enter your subdomain. Then sign in with your email and password, or click Sign in with Google or Sign in with Microsoft 365 if your workspace has SSO enabled.

Why does Gorgias keep saying "your session has expired"? The most common cause is having the same account open in multiple browser tabs at once. Close all but one Gorgias tab, do a hard refresh (Cmd+Shift+R on Mac, Ctrl+F5 on Windows), and clear your cache and cookies if it recurs. Working in a single tab prevents it.

What does "pk is not a valid integer" mean in Gorgias? It means a Gorgias ticket link got its URL rewritten by a third-party app — most often Outlook — so it no longer points at a valid ticket. Instead of clicking the link, copy the URL and paste it directly into your browser's address bar.

I use Google/Microsoft SSO — why can't I change my password? Because you don't have a Gorgias password at all when you sign in through SSO. If you need a direct email-and-password login, run the Forgot password? flow first to create one.

I'm locked out by two-factor authentication — what now? You can't reset your own 2FA token. Ask an Admin on the account to go to Settings → Users & Teams → Users, select your name, and click Reset 2FA Token. Then log in again and re-enroll your authenticator.

Want fewer login and order-status tickets reaching your agents in the first place? Start a free trial and grade a Macha agent against your own Gorgias history before it goes anywhere near your live queue.

Macha

About Macha

Macha is an AI agent platform that works on top of the help desk you already use — Zendesk, Freshdesk, Gorgias, or Front — and connects to the rest of your stack, even your own internal systems. Its AI agents resolve tickets and automate entire workflows end to end, all set up in plain English, no code. Learn more about Macha →

Zendesk
5.0 on Zendesk Marketplace

Loved by support teams worldwide

See what support teams are saying about Macha AI.

The application seems excellent to me! We are still testing, and we need support for some details and they were extremely efficient too!

Daniela Costa

Daniela Costa

Head of Support, Seabra

Macha has been a great addition to our support toolkit. It generates clear, well-organized responses that fit naturally into our workflow. One feature we particularly appreciate is its ability to automatically reply in the same language as the ticket.

Marius F

Marius F

Support Head, Zentana

We've been using Macha for a little while now and it's been really great addition so far! It's powerful, convenient, and makes getting work done a lot easier for our agents.

Alexander Wedén

Alexander Wedén

Head of Support

Support team is very helpful and responsive. Really enjoy how lightweight this is within Zendesk itself vs other more intrusive tools.

Cathleen Wright

Cathleen Wright

Zendesk Admin, Cortex IO

So far it's pretty good! Our queries are a little nuanced, so we can't always use it, but it's got enough utility for us. It can even incorporate our bilingual country with greetings in a second language.

Jae Oliver

Jae Oliver

Head of Support, Wise

Really enjoying using Macha, it has made a noticeable difference to our support team in a short amount of time. I really like the ticket summary feature, saves us a lot of time.

Harry Jackson

Harry Jackson

Head of Support, Crumb

Macha AI is a great addition to my workspace! It's powerful, convenient, and it really makes productivity so much easier for our agents!

Dave G

Dave G

Head of Support, Cyber Power Systems

Very impressed! AI integration for Zendesk has certainly come a long way and Macha seems to set the standard for now. This will for sure save lot of time in our support team.

Pauli Juel

Pauli Juel

Head of CS, Dokument24

Macha has been working great for us so far! The auto-responses are accurate and our resolution time has dropped significantly.

Lana T

Lana T

Zendesk Admin, Swotzy

Macha AI is a great addition. The knowledge base feature means our agents always have the right answers at their fingertips.

Mischa Wolf

Mischa Wolf

Head of Support, Topi

We're enjoying this integration so far. It's made our support team more efficient and our customers get faster responses.

Paula G

Paula G

Head of Customer Support, Xly Studio

The team enjoys using it. It saves considerable time on common questions and the integration options are excellent.

Kilian Leister

Kilian Leister

Support Head, Didriksons

Ready to supercharge your team with AI?

Get started in minutes. Connect your tools, configure your agents, and let AI handle the rest.

7-day free trial · no credit card required