---
title: "Create Brand"
method: POST
path: "/management/v1/projects/{projectId}/branding"
tags: ["Management"]
---

# Create Brand

`POST /management/v1/projects/{projectId}/branding`

Creates a new brand configuration.

You can have only one brand configured for a project.

> 📘 White Labelling
>
> The white labelling settings which can be found in Project Settings > Brand Details and which are available only for Enterprise clients as a separate service can be configured only in the user interface.

## Request body

- ManagementProjectsBrandingCreateRequestBody — Request body schema for **POST** `/management/v1/projects/{projectId}/branding`.
  - `brand` object, required — Defines basic brand details.
    - `name` string, required — Defines brand name.
    - `privacy_policy_url` string, nullable — Defines the URL to the brand's privacy policy. It must be a valid URL format.
    - `terms_of_use_url` string, nullable — Defines the URL to the brand's terms of use. It must be a valid URL format.
    - `permission_reminder` string, nullable — Defines the message that is displayed to customers who opted in an email newsletter.
    - `website_url` string, nullable — Defines the URL to the brand's website. It must be a valid URL format.
  - `address` object, required — Defines the address details.
    - `street` string, required — Defines the brand's street.
    - `city` string, required — Defines the brand's city.
    - `postal` string, nullable, required — Defines the brand's postal code.
    - `state` string — Defines the brand's state or similar administrative area.
    - `country` string, required — Defines the brand's country.
  - `contact` object, required — Defines contact details.
    - `email` string, required — Defines the brand's email address. It must be a valid email format.
    - `phone` string, nullable — Defines the brand's phone number.

## Response `200`

Returns the details about the brand configuration.

- ManagementProjectsBrandingCreateResponseBody — Response brand schema.
  - `id` string, required — Unique identifier of the brand configuration.
  - `brand` object, required — Defines basic brand details.
    - `name` string, required — Defines brand name.
    - `privacy_policy_url` string, nullable, required — Defines the URL to the brand's privacy policy. It must be a valid URL format.
    - `terms_of_use_url` string, nullable, required — Defines the URL to the brand's terms of use. It must be a valid URL format.
    - `permission_reminder` string, required — Defines the message that is displayed to customers who opted in an email newsletter.
    - `website_url` string, nullable, required — Defines the URL to the brand's website. It must be a valid URL format.
  - `address` object, required — Defines the address details.
    - `street` string, required — Defines the brand's street.
    - `city` string, required — Defines the brand's city.
    - `postal` string, nullable, required — Defines the brand's postal code.
    - `state` string, required — Defines the brand's state or similar administrative area.
    - `country` string, required — Defines the brand's country.
  - `contact` object, required — Defines contact details.
    - `email` string, required — Defines the brand's email address. It must be a valid email format.
    - `phone` string, nullable, required — Defines the brand's phone number.

## Other responses

- `400` — Returns an error if the payload has incorrect values.
- `401` — Returns an error if an invalid token was provided.
- `402` — Returns an error if the current plan does not include the Management API feature.
- `404` — Returns an error when a resource could not be found.
- `409` — Returns an error if the brand has been already configured.

---

[API](https://skmtc.net/voucherifyio/apis/voucherify-api-async-actions.md) · [All operations](https://skmtc.net/voucherifyio/apis/voucherify-api-async-actions/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/voucherifyio/voucherify-api-async-actions/versions/4982266e0494/schema)