# Update email branding options (/docs/apis/management/branding/PatchEmailBrandingOptions)

`PATCH /branding/email`

Applies a partial update to the email branding configuration, including subjects and delivery behavior. Only fields included in the request are updated.

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.

## Request body

JSON, required. The request payload used to update the email branding options.

- `welcome` (PatchCustomEmailBrandingOptionsRequest) Configuration for welcome emails, including delivery enablement, subject, and template.
  - `send_notifications` (boolean) 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` (PatchCustomEmailBrandingOptionsRequest) Configuration for user blocked notification emails, including delivery enablement, subject, and template.
  - `send_notifications` (boolean) 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` (PatchCustomEmailBrandingOptionsRequest) Configuration for sign-in code emails, including delivery enablement, subject, and template.
  - `send_notifications` (boolean) 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` (PatchCustomEmailBrandingOptionsRequest) Configuration for sign-in link emails, including delivery enablement, subject, and template.
  - `send_notifications` (boolean) 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` (PatchCustomEmailBrandingOptionsRequest) Configuration for sign-in code and link emails, including delivery enablement, subject, and template.
  - `send_notifications` (boolean) 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` (PatchCustomEmailBrandingOptionsRequest) Configuration for verification code emails, including delivery enablement, subject, and template.
  - `send_notifications` (boolean) 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` (PatchCustomEmailBrandingOptionsRequest) Configuration for verification link emails, including delivery enablement, subject, and template.
  - `send_notifications` (boolean) 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` (PatchCustomEmailBrandingOptionsRequest) Configuration for verification code and link emails, including delivery enablement, subject, and template.
  - `send_notifications` (boolean) 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` (PatchCustomEmailBrandingOptionsRequest) Configuration for password reset code emails, including delivery enablement, subject, and template.
  - `send_notifications` (boolean) 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` (PatchCustomEmailBrandingOptionsRequest) Configuration for password reset link emails, including delivery enablement, subject, and template.
  - `send_notifications` (boolean) 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` (PatchCustomEmailBrandingOptionsRequest) Configuration for password reset code and link emails, including delivery enablement, subject, and template.
  - `send_notifications` (boolean) 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` (PatchCustomEmailBrandingOptionsRequest) Configuration for password updated notification emails, including delivery enablement, subject, and template.
  - `send_notifications` (boolean) 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.

## Response body

`200`, JSON. The branding email options were updated 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

- `400` Bad Request
  - `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.
- `401` Unauthorized
- `403` Forbidden
- `404` Not Found
  Same body as `400`.
- `422` Unprocessable Entity
  - `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.
  - `errors` (Record<string, string[]>, required) A key-value map of validation errors, where each key represents a request field and the value contains one or more messages describing why the request could not be processed.

## Example (MonoCloud .NET SDK)

```csharp
using MonoCloud.Management;
using MonoCloud.Management.Models;
using MonoCloud.Management.Core.Base;

var apiClient = new MonoCloudManagementClient(new MonoCloudConfig("<your-domain>", "[[API-Key]]"));


var requestBody = new PatchEmailBrandingOptionsRequest
  {
    Welcome = new PatchCustomEmailBrandingOptionsRequest
    {
      SendNotifications = false,
      Subject = "Welcome to {{ client.name }}",
    },
    UserBlocked = new PatchCustomEmailBrandingOptionsRequest
    {
      SendNotifications = false,
      Subject = "Welcome to {{ client.name }}",
    },
    SignInCode = new PatchCustomEmailBrandingOptionsRequest
    {
      SendNotifications = false,
      Subject = "Welcome to {{ client.name }}",
    },
    SignInLink = new PatchCustomEmailBrandingOptionsRequest
    {
      SendNotifications = false,
      Subject = "Welcome to {{ client.name }}",
    },
    SignInCodeAndLink = new PatchCustomEmailBrandingOptionsRequest
    {
      SendNotifications = false,
      Subject = "Welcome to {{ client.name }}",
    },
    VerificationCode = new PatchCustomEmailBrandingOptionsRequest
    {
      SendNotifications = false,
      Subject = "Welcome to {{ client.name }}",
    },
    VerificationLink = new PatchCustomEmailBrandingOptionsRequest
    {
      SendNotifications = false,
      Subject = "Welcome to {{ client.name }}",
    },
    VerificationCodeAndLink = new PatchCustomEmailBrandingOptionsRequest
    {
      SendNotifications = false,
      Subject = "Welcome to {{ client.name }}",
    },
    PasswordResetCode = new PatchCustomEmailBrandingOptionsRequest
    {
      SendNotifications = false,
      Subject = "Welcome to {{ client.name }}",
    },
    PasswordResetLink = new PatchCustomEmailBrandingOptionsRequest
    {
      SendNotifications = false,
      Subject = "Welcome to {{ client.name }}",
    },
    PasswordResetCodeAndLink = new PatchCustomEmailBrandingOptionsRequest
    {
      SendNotifications = false,
      Subject = "Welcome to {{ client.name }}",
    },
    PasswordUpdated = new PatchCustomEmailBrandingOptionsRequest
    {
      SendNotifications = false,
      Subject = "Welcome to {{ client.name }}",
    },
  };


var result = await apiClient.Branding.PatchEmailBrandingOptionsAsync(requestBody);
```

## Example (MonoCloud Javascript SDK)

```javascript
import { MonoCloudManagementClient } from '@monocloud/management';

const apiClient = MonoCloudManagementClient.init({ domain: '<your-domain>', apiKey: '[[API-Key]]' });

const requestBody = {
  welcome: {
    send_notifications: false,
    subject: 'Welcome to {{ client.name }}'
  },
  user_blocked: {
    send_notifications: false,
    subject: 'Welcome to {{ client.name }}'
  },
  sign_in_code: {
    send_notifications: false,
    subject: 'Welcome to {{ client.name }}'
  },
  sign_in_link: {
    send_notifications: false,
    subject: 'Welcome to {{ client.name }}'
  },
  sign_in_code_and_link: {
    send_notifications: false,
    subject: 'Welcome to {{ client.name }}'
  },
  verification_code: {
    send_notifications: false,
    subject: 'Welcome to {{ client.name }}'
  },
  verification_link: {
    send_notifications: false,
    subject: 'Welcome to {{ client.name }}'
  },
  verification_code_and_link: {
    send_notifications: false,
    subject: 'Welcome to {{ client.name }}'
  },
  password_reset_code: {
    send_notifications: false,
    subject: 'Welcome to {{ client.name }}'
  },
  password_reset_link: {
    send_notifications: false,
    subject: 'Welcome to {{ client.name }}'
  },
  password_reset_code_and_link: {
    send_notifications: false,
    subject: 'Welcome to {{ client.name }}'
  },
  password_updated: {
    send_notifications: false,
    subject: 'Welcome to {{ client.name }}'
  }
};

const result = apiClient.branding.patchEmailBrandingOptions(requestBody);
```