Register an app

App metadata

• App name appears in authorization and review screens.
• Publisher identifies the organization responsible for the integration.
• Partner app URL is where Workspace sends workspace admins when they click Visit Partner.
• Icon and logo URLs must use https:// in production.

Redirect URIs

• Use exact redirect URLs.
• Avoid wildcards.
• Use http://localhost only for local development.

Scope requests

Start narrow. Add scopes only when the product feature genuinely needs them.

organization:read
client:read
property:read
project:read

Self-serve setup can request read scopes and safe create/update scopes where Workspace APIs support them. Delete scopes require manual Qentrah approval.

Local demo values

Use this local registration when testing the standalone demo app:

Application: Qentrah OAuth Demo
Publisher: ZA
Partner URL: http://localhost:3004
Client ID: partners_client_4p2f001r194s5z6e15473f582m331f4z4s0f
Redirect URI: http://localhost:3004/api/auth/qentrah/callback
Scopes:
calendar:read
client:create
client:read
client:update
media:read
organization:read
project:read
property:read
task:read

Review states

• draft: editable registration.
• pending_review: locked while Qentrah reviews it.
• active: approved for production organization authorization.