---
title: "Assign brand"
method: POST
path: "/v2/brands/{brand_id}/assign"
---

# Assign brand

`POST /v2/brands/{brand_id}/assign`

## Request

- Base URL: `https://api.signnow.com`
- URL: `https://api.signnow.com/v2/brands/{brand_id}/assign`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/signnow/apis/signnow-api/docs/v2/brands/:brand_id/assign/post.ts> (a function with typed inputs; its response is checked against the schema)

> [!WARNING]
> This endpoint is deprecated.

This endpoint allows users to assign branding to an entity.

## Request body

- object
  - `entity_type` string, required: Must be `application`, `document`, `document_group`. Coming soon: `organization`.
  - `entity_unique_id` string, required: The specified application ID.

## Response `201`

Created

- object

## Other responses

- `400`: * Request without token/with invalid external bearer token/ with external app basic token * Request with valid bearer token from other user logged in * Request with invalid payload * Request with `entity_type` is not string * Request with `entity_type` is missing * Request with `entity_type` is empty * Request with `entity_type` is not `application`, `document`, `document_group` * Request with `entity_unique_id` is not string * Request with `entity_unique_id` is missing * Request with `entity_unique_id` is empty * Request when brand assignment already exists for the `application`, `document`, `document_group`
- `403`: * Request with `entity_unique_id` does not exist - 40 characters * Request with another user’s `entity_unique_id` * Request with `entity_unique_id` for deleted/deactivated application
- `404`: * Request with a Bearer token from a user authorised with an external token from the app they don’t own * Request with `brand_id` which does not exist

---

[API](https://skmtc.dev/signnow/apis/signnow-api.md) - [All operations](https://skmtc.dev/signnow/apis/signnow-api/llms.txt) - [OpenAPI document](https://skmtc.dev/signnow/apis/signnow-api/revisions/1c9c30a6142b?raw)