Integrations
Fixing a broken connection
What an expired or revoked connection looks like from the channel, and how to repair it.
Connections expire. OAuth tokens age out, passwords change, admins revoke apps, people leave. This is the most common thing that goes wrong with Gini and it's usually a 30-second fix.
What it looks like
In a channel, mid-job:
I can't reach HubSpot: the connection expired. [Reconnect] and I'll carry on from here.
From a routine, at its scheduled time:
The Monday report didn't run. My Google connection needs reconnecting.
And in app.ginicomputer.com → Integrations, the connection shows as broken with a reconnect button.
Gini tells you. It doesn't skip the step and produce a report that quietly omits a source.
Fixing it
Click reconnect and authorise again. If you're mid-job, Gini picks up where it stopped rather than starting over.
If reconnecting doesn't hold:
Check the tool's own app permissions. Google, HubSpot and GitHub all have a page listing connected apps. If Gini isn't there, or is there with less access than before, that's your answer.
Check whether an admin revoked it. Workspace admins can revoke third-party apps for everyone. If several people's connections broke at once, this is why.
Check your own access first. If your HubSpot login stopped working, Gini's use of it stopped too. Gini has your access, no more.
Reconnecting doesn't lose anything
Your routines, skills, wiki and history are unaffected. Reconnecting restores reach to the tool, nothing else changes.
Routines that broke
A routine whose owner's connection expired stops and says so in its channel at the time it should have run. It doesn't run with less data.
Once the owner reconnects, the routine resumes on its next scheduled run. If you need the missed one, ask in the channel: "@Gini run the Monday report now".
Someone left the company
Their connections go with them, and anything depending on those connections stops.
Before an offboarding, reassign their routines and have someone else connect the tools those routines need. Afterwards, the fix is the same but you'll find out by way of a routine failing. People and permissions has the checklist.
Connections that break repeatedly
Some tools expire tokens aggressively, and some workspaces have policies that revoke third-party apps on a schedule. If you're reconnecting the same tool every few weeks, tell us at team@ginicomputer.com: it's worth us looking at the specific tool rather than you clicking a button forever.