https://demo.notifuse.com/api/user.rootSignin Authenticates the root user using HMAC signature for programmatic access. This endpoint is designed for automation scenarios like Infrastructure-as-Code deployments, CI/CD pipelines, and automated testing where magic link authentication is impractical.
Security Features:
- HMAC-SHA256 signature verification using the application's secret key
- 60-second timestamp window to prevent replay attacks
- Rate limited to 5 attempts per 5 minutes per email
- Only works for a configured root email address (ROOT_EMAIL may list several, comma/semicolon-separated)
How to generate the signature:
SECRET_KEY="your-notifuse-secret-key" # the first key when SECRET_KEY lists several
ROOT_EMAIL="admin@example.com"
TIMESTAMP=$(date +%s)
MESSAGE="${ROOT_EMAIL}:${TIMESTAMP}"
SIGNATURE=$(echo -n "$MESSAGE" | openssl dgst -sha256 -hmac "$SECRET_KEY" | awk '{print $2}')Body application/json
The root user's email address (must match one of the configured ROOT_EMAIL addresses)
- Example: admin@example.com
Unix timestamp (seconds since epoch). Must be within 60 seconds of server time.
- Example: 1735600000
HMAC-SHA256 signature computed as: HMAC-SHA256(email + ":" + timestamp, SECRET_KEY), with the first key when SECRET_KEY lists several. The signature should be hex-encoded.
- Example: a1b2c3d4e5f6...
Response
200 Authentication successful object
JWT authentication token for subsequent API requests
- Example: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
User account information
Show child attributes
Unique user identifier
- Example: usr_1234567890
User's email address
- Example: admin@example.com
User's display name
- Example: Admin User
User's preferred locale for the console UI and system emails
- Example: en
Account creation timestamp
- Example: 2025-01-01T00:00:00Z
Last update timestamp
- Example: 2025-01-01T00:00:00Z
Token expiration timestamp
- Example: 2025-01-01T12:00:00Z
400 Bad request - missing required fields object
Error message
401 Unauthorized - invalid credentials object
Error message
405 Method not allowed object
Error message