---
title: "Branding"
description: "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."
url: https://www.unitpost.com/docs/api/branding
section: API reference
updated: 2026-10-13
---
# Branding

## Branding

> 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))

## Related

- [Workspace](https://www.unitpost.com/docs/api/workspace): The workspace's name and image (writes need `branding:write`), who is calling (`GET /whoami`, any credential), and the activity log (`GET /activity`, `activity:read`: no key preset includes it).
- [Segments](https://www.unitpost.com/docs/api/segments): Named groups of contacts used to target campaigns. Segments decide who a campaign goes to; topics (below) decide what recipients can opt out of.
- [Topics](https://www.unitpost.com/docs/api/topics): Subscription categories (e.g. Promotions) recipients can opt out of without leaving your list, independent of segment membership. Scope a campaign to a topic and opted-out contacts are skipped automatically.