# Retrieve email branding options (/docs/apis/management/branding/FindEmailBrandingOptions) `GET /branding/email` Retrieves the current email branding configuration, including subjects and delivery behavior for system-generated emails. Base URL: `https://{tenant}.{region}.monocloud.com/api`, where `{tenant}`, `{region}` (one of us, eu, in) come from your tenant. Authentication: send your Management API key in the `X-API-KEY` header. ## Response body `200`, JSON. The branding email options were retrieved successfully Returns `EmailBrandingOptions`. - `welcome` (CustomEmailBrandingOptions, required) Configuration for welcome emails, including delivery enablement, subject, and template. - `send_notifications` (boolean, required) Specifies whether the email notification is sent using MonoCloud-managed delivery. - `subject` (string) Specifies the email subject line, which may include Liquid placeholders; when empty, the default subject template is used. - `user_blocked` (CustomEmailBrandingOptions, required) Configuration for user blocked notification emails, including delivery enablement, subject, and template. - `send_notifications` (boolean, required) Specifies whether the email notification is sent using MonoCloud-managed delivery. - `subject` (string) Specifies the email subject line, which may include Liquid placeholders; when empty, the default subject template is used. - `sign_in_code` (CustomEmailBrandingOptions, required) Configuration for sign-in code emails, including delivery enablement, subject, and template. - `send_notifications` (boolean, required) Specifies whether the email notification is sent using MonoCloud-managed delivery. - `subject` (string) Specifies the email subject line, which may include Liquid placeholders; when empty, the default subject template is used. - `sign_in_link` (CustomEmailBrandingOptions, required) Configuration for sign-in link emails, including delivery enablement, subject, and template. - `send_notifications` (boolean, required) Specifies whether the email notification is sent using MonoCloud-managed delivery. - `subject` (string) Specifies the email subject line, which may include Liquid placeholders; when empty, the default subject template is used. - `sign_in_code_and_link` (CustomEmailBrandingOptions, required) Configuration for sign-in code and link emails, including delivery enablement, subject, and template. - `send_notifications` (boolean, required) Specifies whether the email notification is sent using MonoCloud-managed delivery. - `subject` (string) Specifies the email subject line, which may include Liquid placeholders; when empty, the default subject template is used. - `verification_code` (CustomEmailBrandingOptions, required) Configuration for verification code emails, including delivery enablement, subject, and template. - `send_notifications` (boolean, required) Specifies whether the email notification is sent using MonoCloud-managed delivery. - `subject` (string) Specifies the email subject line, which may include Liquid placeholders; when empty, the default subject template is used. - `verification_link` (CustomEmailBrandingOptions, required) Configuration for verification link emails, including delivery enablement, subject, and template. - `send_notifications` (boolean, required) Specifies whether the email notification is sent using MonoCloud-managed delivery. - `subject` (string) Specifies the email subject line, which may include Liquid placeholders; when empty, the default subject template is used. - `verification_code_and_link` (CustomEmailBrandingOptions, required) Configuration for verification code and link emails, including delivery enablement, subject, and template. - `send_notifications` (boolean, required) Specifies whether the email notification is sent using MonoCloud-managed delivery. - `subject` (string) Specifies the email subject line, which may include Liquid placeholders; when empty, the default subject template is used. - `password_reset_code` (CustomEmailBrandingOptions, required) Configuration for password reset code emails, including delivery enablement, subject, and template. - `send_notifications` (boolean, required) Specifies whether the email notification is sent using MonoCloud-managed delivery. - `subject` (string) Specifies the email subject line, which may include Liquid placeholders; when empty, the default subject template is used. - `password_reset_link` (CustomEmailBrandingOptions, required) Configuration for password reset link emails, including delivery enablement, subject, and template. - `send_notifications` (boolean, required) Specifies whether the email notification is sent using MonoCloud-managed delivery. - `subject` (string) Specifies the email subject line, which may include Liquid placeholders; when empty, the default subject template is used. - `password_reset_code_and_link` (CustomEmailBrandingOptions, required) Configuration for password reset code and link emails, including delivery enablement, subject, and template. - `send_notifications` (boolean, required) Specifies whether the email notification is sent using MonoCloud-managed delivery. - `subject` (string) Specifies the email subject line, which may include Liquid placeholders; when empty, the default subject template is used. - `password_updated` (CustomEmailBrandingOptions, required) Configuration for password updated notification emails, including delivery enablement, subject, and template. - `send_notifications` (boolean, required) Specifies whether the email notification is sent using MonoCloud-managed delivery. - `subject` (string) Specifies the email subject line, which may include Liquid placeholders; when empty, the default subject template is used. ## Errors - `401` Unauthorized - `403` Forbidden - `404` Not Found - `type` (string, required) A URI reference that identifies the error type. When accessed, it may provide human-readable documentation. - `title` (string, required) A short, human-readable summary of the error. - `status` (integer, required, int32) The HTTP status code associated with this error response. - `trace_id` (string, required) A unique identifier for the request, used for tracing and diagnostics. - `detail` (string) A human-readable explanation specific to this occurrence of the error. - `instance` (string) A URI reference that identifies the specific occurrence of the error. ## Example (MonoCloud .NET SDK) ```csharp using MonoCloud.Management; using MonoCloud.Management.Core.Base; var apiClient = new MonoCloudManagementClient(new MonoCloudConfig("", "[[API-Key]]")); var result = await apiClient.Branding.FindEmailBrandingOptionsAsync(); ``` ## Example (MonoCloud Javascript SDK) ```javascript import { MonoCloudManagementClient } from '@monocloud/management'; const apiClient = MonoCloudManagementClient.init({ domain: '', apiKey: '[[API-Key]]' }); const result = apiClient.branding.findEmailBrandingOptions(); ```