Skip to the content
Agoo Help

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
  1. Go to ConsoleDevelopersApps and select Register an App.

  2. Give it a name people will recognise.
  3. Choose It runs on a server or It's a native app.
  4. Add its Redirect addresses, one a line.
  5. 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.