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)
Unix timestamp (seconds since epoch). Must be within 60 seconds of server time.
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.
Response
200 Authentication successful object
JWT authentication token for subsequent API requests
User account information
Show 6 child attributes Hide 6 child attributes
Unique user identifier
User's email address
User's display name
User's preferred locale for the console UI and system emails
Account creation timestamp
Last update timestamp
Token expiration timestamp
400 Bad request - missing required fields object
Error message
401 Unauthorized - invalid credentials object
Error message
405 Method not allowed object
Error message