Register an OAuth App
Register an app that other organisations' people can connect, with its redirect addresses and its secret.
- Plans: Pro and up
- Updated 4 November 2026
- 1 min read
Go to ConsoleDevelopersApps and select Register an App.
- Give it a name people will recognise.
- Choose It runs on a server or It's a native app.
- Add its Redirect addresses, one a line.
- Select Register. Copy the secret now, because it's shown once.
Good to Know
- For your own systems an API key is simpler. An app is for when other people connect it to their own Agoo.
- Redirect addresses are compared exactly: no wildcards, and a different path or query is a different address.
- A server's addresses are https. A native app may also use a private-use scheme or http://127.0.0.1.
- Change Secret gives you a new one, and the old one keeps working for a day, so you can move across without an outage.
- Revoke stops the app for every organisation at once. It can't be undone.
If Something Goes Wrong
- "isn't a redirect address we can use": use a full https address with no wildcard or fragment.
- People see "An Owner or Admin has to approve this first": that's how it works. An Owner or Admin of their organisation connects it once, then their people can.
Was this helpful?
Still Stuck?
Ask in your own words. If it needs a person, we'll bring one in.