Hydrix site template
Demonstrate custom Cognito email branding through the Admin API.
This starter gives your site a working /admin console for managing separate branding templates for admin users and data-system visitors.
Why this template exists
Keep admin and visitor branding independent.
Hydrix stores Cognito auth-email branding per site and applies it separately to the admin pool and the data/visitor pool. This template shows both flows side by side so teams can test, iterate, and save each template without redeploying the site.
- Separate editor cards for admin and data / visitor branding
- Buttons to load example copy, save a single pool, clear a single pool, or clear both pools
- Live request preview for the exact payload sent to the Admin API
- Hosted UI login and sign-out flow for `super-admin` users
Supported placeholders
Use neutral copy that works across Cognito flows.
{{code}}{{link}}{{username}}{{email}}{{siteId}}{{siteDomain}}
The same template can be reused for sign-up verification, resend code, email-attribute verification, and forgot-password messages. Keep {{code}} as the primary call to action and treat{{link}} as optional.
Admin pool
Example admin branding
Brand security emails for the site admin pool with support-oriented admin copy, a separate display name, and its own reply-to address.
Data / visitor pool
Example visitor branding
Keep visitor emails distinct from admin communications. This template uses a separate display name and account-oriented message copy for the data-system pool.
Endpoint shape
Use the dedicated auth-email-branding route.
The branding console calls GET /admin/api/auth-email-branding to load current values andPUT /admin/api/auth-email-branding to upsert or clear branding.
{
"adminVerificationEmail": {
"fromDisplayName": "Northwind Admin",
"replyToEmailAddress": "support@example.com",
"subject": "Your Northwind admin security code",
"body": "<p>Use this code to continue with your admin account:</p><p><strong>{{code}}</strong></p><p>If you did not request this email, you can ignore it.</p>"
},
"dataVerificationEmail": {
"fromDisplayName": "Northwind Visitors",
"replyToEmailAddress": "help@example.com",
"subject": "Your Northwind account security code",
"body": "<p>Use this code to continue with your account:</p><p><strong>{{code}}</strong></p><p>This message can be used for sign-up, email confirmation, or password reset.</p>"
}
}