Help / Tutorials

Developers About 30 minutes

#Register an application and launch it from the Hub

1. Applications → Register app. Choose the slug carefully, because it's permanent. Add your launch URL.
2. Permissions & roles. Add permissions like app.notes.edit, role names like editor and viewer, and pick a default role.
3. API Keys → Create key, scoped to your app, with entitlements.manage and users.list. Put the secret in your backend.
4. Webhooks → Add webhook for access.revoked and role.removed, pointing at your backend. Verify signatures as in Receiving webhooks.
5. Grant yourself access: Users → you → Access → Grant → your app.
6. On Home, your app's tile appears. Tap it. The Hub mints a 5-minute app token and opens your launch URL. Your app verifies the token against Substratal's public keys.

Self-registered apps wait for staff review before other people can see them. Your own access works straight away.

Screens in this tutorial

APL-02 · Register application APL-03 · Application — Overview APL-05 · Permissions & roles KEY-02 · Create API key WHK-02 · Add / edit webhook ACX-02 · Grant access APP-01 · Home — My Apps APP-03 · Launch app

Last updated 2026-10-23 · Built 2026-10-25 from a9ef3be · API 1.0.0-draft.13 · Substratal-Version: 1