Account & Teams
Set up your organization, manage users, and organize teams.
Account & Teams
Set up your organization, manage users, and organize teams.
Account Setup
After signing up, complete your organization profile:
- Organization name — e.g., "Your Company"
- Subdomain —
your-company.notifyhero.com - Default timezone — used for schedules and reports
- Logo — displayed in status pages and notifications
Go to Settings → Organization to configure.
User Management
Inviting Users
Go to Settings → Users → Invite.
- Email invite — send an invitation link
- Bulk invite — upload a CSV with name and email
- SSO auto-provisioning — users are created on first SSO login (Business+ plans)
- SCIM — sync users from your identity provider (Enterprise)
Roles
| Role | Permissions |
|---|---|
| Owner | Full access. Billing, settings, delete org. |
| Admin | Manage users, teams, services, integrations. |
| Manager | Manage their team's schedules and policies. |
| Responder | Respond to incidents, view dashboards. |
| Stakeholder | View-only access to incidents and status pages. |
| Limited Stakeholder | View-only for specific services. |
Assign roles at Settings → Users → [User] → Role.
Teams
Teams group people and services together.
Creating a Team
Go to Settings → Teams → New Team.
- Name:
Platform Engineering - Members: Add users from your organization
- Manager: Designate a team lead
Team Structure
Engineering
├── Platform Team (4 people, 3 services)
├── Payments Team (3 people, 2 services)
└── Mobile Team (5 people, 2 services)Teams can be nested. Escalation policies and schedules are set per team.
Profile Settings
Each user configures their own profile at Profile:
- Contact methods — phone number, email, Slack handle
- Notification rules — how and when to be notified
- Quiet hours — suppress low-urgency outside these hours
- Timezone — for schedule display
- Calendar sync — iCal feed for on-call shifts
Authentication
Password
Standard email + password authentication with optional 2FA (TOTP).
SSO (Business+ Plans)
- SAML 2.0 — Okta, Azure AD, OneLogin, Google Workspace
- OIDC — any OpenID Connect provider
SCIM (Enterprise)
Auto-provision and deprovision users from your identity provider. When someone leaves your company, their NotifyHero access is revoked automatically.
API Keys
Generate API keys at Settings → API Keys.
- Organization keys — full access to the API
- Service keys — scoped to a specific service (for integrations)
- Personal tokens — scoped to the user's permissions
# Create via CLI
curl -X POST https://api.notifyhero.com/v1/api-keys \
-H "Authorization: Bearer nh_live_abc123" \
-d '{"name": "CI/CD Pipeline", "role": "service", "service_id": "srv_abc123"}'Rotate keys regularly. Revoke compromised keys immediately at Settings → API Keys.