Create an OAuth app
Register your app with Cencori to get a client ID and secret.
An OAuth app is your product's identity on Cencori. People see its name when they are asked to approve access.
Register the app
- Open Organization settings → OAuth apps. You need to be an owner or admin of the organization.
- Click New app and fill in:
- Click Create app. Cencori shows the client ID (
coa_…) and client secret (cos_…).
The secret is shown once. Store it on your server, in the same place as your other credentials. Never ship it in a browser bundle, a mobile app or a public repository.
Redirect addresses
A redirect address must be:
https://, on any host and path, orhttp://onlocalhost,127.0.0.1or[::1], for development.
It cannot contain a wildcard, a # fragment or a username and password. A query string is allowed.
Cencori compares the redirect_uri in a request with your list as text. https://app.example.com/callback and https://app.example.com/callback/ are different addresses. Register each one you use, including the port for localhost.
Change or remove an app
In Organization settings → OAuth apps:
- Edit changes the name, description, website, redirect addresses and permissions. Removing a permission also removes it from everyone who already approved the app.
- New secret replaces the client secret. The old secret stops working at once, so your app cannot get or refresh tokens until you deploy the new one. Tokens already issued keep working.
- Delete removes the app. Everyone who approved it loses the connection and its tokens stop working at once. This cannot be undone.
An organization can register up to 25 apps.

