Organizations

Organizations are the top-level container in Hooklistener. All resources — endpoints, monitors, secrets, and API keys — belong to an organization.

How organizations work

When you create a Hooklistener account, a personal organization is automatically created for you. You can create additional organizations or be invited to existing ones.

Multi-tenant architecture

Each organization is fully isolated:

• Endpoints are scoped to an organization
• Uptime monitors belong to an organization
• API keys are created per organization
• Secrets are encrypted per organization
• Billing is managed per organization

Roles

Role	Description
Owner	Full access to all features, billing, and member management. Cannot be removed.
Admin	Can manage members, API keys, and organization settings. Can't open the Billing page, but can create, cancel or resume a subscription through the API with a user session.
Member	Can view and create resources (endpoints, monitors). Cannot manage members or billing.

Switching organizations

Dashboard

Click the organization selector in the navigation to switch between organizations.

CLI

# List organizations
hooklistener org list

# Switch to a different organization
hooklistener org use <organization-id>

API

API keys are scoped to a specific organization. To work with a different organization, use a key from that organization.

For JWT authentication, include the organization header:

curl https://app.hooklistener.com/api/v1/endpoints \
  -H "Authorization: Bearer <jwt_token>" \
  -H "x-organization-id: <organization-id>"

Inviting members

1. Go to Organization Settings > Members
2. Click Invite Member
3. Enter the email address
4. The invitee receives an email with a link to accept

Or via the API:

curl -X POST https://app.hooklistener.com/api/v1/organizations/<org-id>/members/invite \
  -H "Authorization: Bearer hklst_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"email": "[email protected]"}'

Organization settings

Manage your organization from Organization Settings:

• General — name and basic settings
• Members — invite, manage, and remove members
• API Keys — create and revoke API keys
• Billing — manage subscription and plan
• Audit Log — review activity history (Production, Scale and Enterprise plans)