---
title: "Branding API"
description: "The look marketing emails' footer and the hosted unsubscribe page share, with the same options as Settings → Brand, and the logo."
url: https://www.unitpost.com/docs/platform/branding
section: "Platform API reference"
updated: 2026-10-13
---
# Branding API

> The look marketing emails' footer and the hosted unsubscribe page share, with the same options as Settings → Brand, and the logo. Writes need `branding:write`, which no key preset includes.

Full schemas: [OpenAPI 3.1](https://www.unitpost.com/api/v1/openapi.json). HTML reference: https://www.unitpost.com/docs/platform/branding.

## Operations

### `GET /api/v1/branding`

Retrieve branding

The look marketing emails' footer and the hosted unsubscribe page share, as Settings → Brand shows it: colors, the font, the company name and postal address, the page's copy and behavior, the footer's labels, the logo, and whether the "Sent with Unitpost" mark shows. `null` means the default; `company_name` falls back to the workspace's name, so send it only to pin a different one. Requires the `templates:read` capability.

Reference: https://www.unitpost.com/docs/platform/get-branding ([Markdown](https://www.unitpost.com/docs/platform/get-branding.md))

### `PATCH /api/v1/branding`

Update branding

Change branding with the same options Settings → Brand offers; only the fields you send change, and `null` restores a default. The footer every marketing email carries is built from these at send (it always keeps the unsubscribe link and the postal address). Hiding the "Sent with Unitpost" mark needs a paid plan (`403 limit_reached`). No key preset includes this capability: tick it on the key. Requires the `branding:write` capability.

Reference: https://www.unitpost.com/docs/platform/patch-branding ([Markdown](https://www.unitpost.com/docs/platform/patch-branding.md))

### `PUT /api/v1/branding/logo`

Set the logo

Replace the logo marketing emails and the unsubscribe page show, from a public https `url` or base64 `data` (PNG, JPEG, GIF or WebP, up to 5 MB and 16,384 px a side). Requires the `branding:write` capability.

Reference: https://www.unitpost.com/docs/platform/put-branding-logo ([Markdown](https://www.unitpost.com/docs/platform/put-branding-logo.md))

### `DELETE /api/v1/branding/logo`

Remove the logo

Clear the brand logo: the workspace image shows instead, else none. Requires the `branding:write` capability.

Reference: https://www.unitpost.com/docs/platform/delete-branding-logo ([Markdown](https://www.unitpost.com/docs/platform/delete-branding-logo.md))