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. Cannot manage billing. |
| 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
- Go to Organization Settings > Members
- Click Invite Member
- Enter the email address
- 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
- Notifications — configure email, Slack, and Telegram alerts
- API Keys — create and revoke API keys
- Billing — manage subscription and plan
- Audit Log — review activity history (paid plans)