Custom Branding

Add your company logo and brand colors to every generated document. Available on Starter and Growth plans.

Dashboard Setup

The easiest way to configure branding is through the Kagyz Dashboard.

Logo

Upload a PNG, JPG, or SVG file (max 500KB). Your logo appears in the top-left corner of all generated documents. For RTL documents, it appears in the top-right.

Accent Color

Set a hex color (e.g. #22c55e) that applies to the document title, company name, total section borders, and key data values.

Per-Request Accent Color Override

You can override the accent color on any API request by adding a branding field to the request body. This takes priority over the dashboard setting.

bash

curl -X POST https://api.kagyz.com/v1/invoice \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "invoice_number": "INV-001",
    "issue_date": "2026-03-15",
    "currency": "USD",
    "branding": {
      "accent_color": "#ff6600"
    },
    "from": {
      "name": "Acme Corp",
      "email": "billing@acme.com"
    },
    "to": {
      "name": "Client Inc",
      "email": "ap@client.com"
    },
    "items": [
      { "description": "Design services", "quantity": 1, "unit_price": 500 }
    ]
  }' \
  --output invoice.pdf

The branding.accent_color field works on all 5 document types: invoice, receipt, quote, credit-note, and packing-slip.

Priority Order

Priority	Source
1 (highest)	Per-request `branding.accent_color`
2	Dashboard branding settings
3 (default)	Default color `#0a2540`

Notes

Logo can only be uploaded via the dashboard. It cannot be overridden per-request.
Accent color must be a valid 6-character hex color starting with #.
If no branding is configured, documents use the default dark navy color, matching the original template design.
Branding applies to all 5 document types: invoice, receipt, quote, credit note, and packing slip.