Platform Guides
Application Branding
Customize sender display names, dynamic email handles, and template brand colors.
Application Branding
GNS allows each application to define distinct visual branding, custom display names, and sender handles for all outbound communication.
1. Branding Properties
Every application profile includes the following branding configuration:
| Property | Default Value | Description |
|---|---|---|
name | (Application Name) | Visible sender display name (e.g. "Acme Cloud"). |
sender_handle | slug | Pre-at handle for shared email sending ({sender_handle}@iitdeveloper.com). |
brand_color | #16A34A | Primary accent color (hex format) applied to email buttons and banners. |
logo_url | null | Publicly accessible HTTPS URL of the application's logo image. |
reply_to | support@iitdeveloper.com | Default reply-to email address. |
2. Updating Branding via API
You can update an application's branding programmatically:
curl -X PATCH "https://api.gns.iitdeveloper.com/api/v1/applications/app_99182/branding" \
-H "Authorization: Bearer <keycloak_jwt_token>" \
-H "Content-Type: application/json" \
-d '{
"display_name": "Acme Notifications",
"brand_color": "#16A34A",
"logo_url": "https://cdn.acme.com/brand/logo.png",
"reply_to": "help@acme.com"
}'Response200 OK
{
"id": "app_99182",
"display_name": "Acme Notifications",
"sender_handle": "acme-notifications",
"sender_email": "acme-notifications@iitdeveloper.com",
"brand_color": "#16A34A",
"logo_url": "https://cdn.acme.com/brand/logo.png",
"reply_to": "help@acme.com"
}