// DEVELOPERS/Guides/App directory

App directory

Build a public app once. Install it across any ALLO workspace. Surface UI inside the canvas, listen to events, and show up in the directory next to first party integrations.

What apps can do

  • Register custom block types that render inside the canvas iframe.
  • Subscribe to webhooks for any workspace that installs the app.
  • Add commands to the global search and command palette.
  • Provide settings UI inside the workspace dashboard.

App manifest

FieldDescription
nameDisplay name shown in the directory.
scopesList of OAuth scopes the app requires.
blocksCustom block types your app registers.
commandsSlash commands and palette entries.
webhook_urlEndpoint for installed workspace events.
settings_urlURL embedded as iframe in workspace settings.

Review and publish

  1. Submit your app from Settings, Developers, Apps.
  2. We review for security, privacy, and basic UX. Median turnaround is 5 business days.
  3. On approval, the app shows up in the directory.
  4. Updates reuse the same listing. Major version bumps require user re-consent for new scopes.

Revenue share

Free apps are free. Paid apps run on Stripe Connect. ALLO takes 15 percent on the first $1M of annual app revenue, 5 percent above that.

// NOTE
Partner program available for apps that meet usage and quality thresholds. Contact partners@allo.io.