---
title: "Create and submit a brand"
method: POST
path: "/v1/projects/{projectId}/brands:submit"
tags: ["brands"]
---

# Create and submit a brand

`POST /v1/projects/{projectId}/brands:submit`

The endpoint creates and submits a new brand for the specified project in new status. The brand is validated against the brand type format.

## Path parameters

- `projectId` string, required

## Request body

- Brand — The brand object that contains the brand details.
  - `brandId` string — The unique identifier for the brand.
  - `brandName` string — The name of the brand.
  - `brandMetadataId` string — The unique identifier for the brand metadata.
  - `status` 'DRAFT' | 'NEW' | 'PENDING' | 'PENDING_REVIEW' | 'REJECTED' | 'INCOMPLETE' | 'COMPLETED' | 'ARCHIVED', enum
  - `data` BrandCategory[] — The list of categories included in the brand metadata. Each of them includes a list of attributes.
  - `logs` BrandLog[] — The list of logs related to the brand.
    - `status` 'DRAFT' | 'NEW' | 'PENDING' | 'PENDING_REVIEW' | 'REJECTED' | 'INCOMPLETE' | 'COMPLETED' | 'ARCHIVED', enum
    - `createTime` string, date-time — The date and time when the brand status was changed.
    - `comment` string — The message related to the brand status change.
    - `author` 'CUSTOMER' | 'AGENT', enum — Author. It can be either a customer or an agent.
  - `callbackUrl` string — The URL to receive the brand status update callback. The URL must be a valid URL and must be reachable from Sinch.
  - `createTime` string, date-time — The date and time when the brand was created.
  - `updateTime` string, date-time — The date and time when the brand was updated.

## Response `200`

Brand created and submitted successfully

- Brand — The brand object that contains the brand details.
  - `brandId` string — The unique identifier for the brand.
  - `brandName` string — The name of the brand.
  - `brandMetadataId` string — The unique identifier for the brand metadata.
  - `status` 'DRAFT' | 'NEW' | 'PENDING' | 'PENDING_REVIEW' | 'REJECTED' | 'INCOMPLETE' | 'COMPLETED' | 'ARCHIVED', enum
  - `data` BrandCategory[] — The list of categories included in the brand metadata. Each of them includes a list of attributes.
  - `logs` BrandLog[] — The list of logs related to the brand.
    - `status` 'DRAFT' | 'NEW' | 'PENDING' | 'PENDING_REVIEW' | 'REJECTED' | 'INCOMPLETE' | 'COMPLETED' | 'ARCHIVED', enum
    - `createTime` string, date-time — The date and time when the brand status was changed.
    - `comment` string — The message related to the brand status change.
    - `author` 'CUSTOMER' | 'AGENT', enum — Author. It can be either a customer or an agent.
  - `callbackUrl` string — The URL to receive the brand status update callback. The URL must be a valid URL and must be reachable from Sinch.
  - `createTime` string, date-time — The date and time when the brand was created.
  - `updateTime` string, date-time — The date and time when the brand was updated.

## Other responses

- `400` — BAD_REQUEST: Brand validation error
- `500` — INTERNAL: Internal server error. Typically, a server bug.

---

[API](https://skmtc.net/sinch/apis/sinch-brands-api.md) · [All operations](https://skmtc.net/sinch/apis/sinch-brands-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sinch/sinch-brands-api/revisions/b49d3ae283fd/schema)