Brand profiles: your customers’ logos on their reports
White labeling gains a third layer. A brand profile is a saved brand for one
of your own customers: company name, contact block, colours and, for the first time, a logo.
Create one per customer, and put its id on any PDF link as ?brand=. The report
renders in that customer's brand, logo included, on an order you placed.
POST /api/v1/branding/profilescreates a profile;PUT …/:id/logotakes the image bytes. List, get, patch and delete are there too. Reference.?brand=<profileId>on the PDF route. Explicit query params still win over the profile, field by field; the profile replaces your account defaults wholesale.- In the dashboard, Report branding is now Branding with two tabs: your Defaults, and Profiles, where each profile shows its id, a logo upload and a test PDF.
- Up to 500 profiles per account. A profile from another account, or an unknown id, is a
404, the same as an unknown order.
Nothing changes for existing integrations: a link with no ?brand= renders exactly
as before, and the per-download params behave as they did.
How white-label branding works has the
walkthrough.