Organizations

An organization is the top-level container in Hook0 that groups applications, manages team members, and controls billing. Organizations enable multi-tenant architectures where different teams or customers have isolated webhook infrastructures.

Key Points

• Organizations contain Applications and team members
• Each organization has its own quotas, plan, and billing
• Members can have different roles (Editor, Viewer)
• Organizations provide complete isolation between tenants

Relationship to Other Concepts

Organization (Acme Corp)
    |
    +-- Members
    |       +-- Alice (Editor)
    |       +-- Bob (Viewer)
    |
    +-- Applications
    |       +-- Order Service
    |       +-- User Service
    |
    +-- Plan & Quotas

Multi-Tenancy

Organizations are the foundation of Hook0's multi-tenant architecture:

• SaaS providers can create one organization per customer
• Enterprises can create one organization per department or team
• Agencies can create one organization per client project

Each organization operates independently with its own:

• Applications and event types
• Subscriptions and secrets
• Usage quotas and billing
• Team members and permissions

Member Roles

Organizations support role-based access control:

• Editor - Full access: create, edit, delete applications, manage members
• Viewer - Read-only access to applications and events

Quotas

Organizations have quotas that limit resource usage based on the billing plan:

• Members per organization - Maximum team members
• Applications per organization - Maximum applications
• Events per day - Maximum events across all applications
• Event retention - How long events are stored

Onboarding Progress

Hook0 tracks organization setup through steps:

1. Application - Create at least one application
2. Event Type - Define at least one event type
3. Subscription - Configure at least one webhook endpoint
4. Event - Send your first event

Lifecycle

Before deleting an organization:

• All applications must be deleted first
• This is enforced to prevent accidental data loss

Irreversible Action

Organization deletion cannot be undone. Ensure all applications are removed and data is backed up before proceeding.

What's Next?

• Applications - Creating applications within your organization
• Service Tokens - API access for automated systems
• Events - Sending your first webhook event
• Getting Started - Set up your first organization