---
title: "Create or update domain QR code settings"
method: POST
path: "/domains/qrCodeSettings/{domainId}"
tags: ["QR Codes"]
---

# Create or update domain QR code settings

`POST /domains/qrCodeSettings/{domainId}`

## Request

- Base URL: `https://api.short.io`
- URL: `https://api.short.io/domains/qrCodeSettings/{domainId}`
- Auth: API key in header `Authorization`

Creates or updates the default QR code settings applied to the domain's links.

## Path parameters

- `domainId` number, required

## Request body

- object
  - `color` string: QR code foreground color as hex (RRGGBB or RRGGBBAA)
  - `backgroundColor` string: QR code background color as hex
  - `logoUrl` string: URL of the logo image embedded in the QR code
  - `logoHeight` number: Logo height in pixels
  - `logoWidth` number: Logo width in pixels
  - `ecLevel` 'L' | 'M' | 'Q' | 'H': QR code error correction level
  - `borderRadius` number: Module border radius in pixels
  - `noExcavate` boolean: Disable logo area excavation
  - `finderOuterShape` 'square' | 'rounded' | 'circle' | 'drop': Shape of the outer finder pattern
  - `finderInnerShape` 'square' | 'rounded' | 'circle' | 'drop': Shape of the inner finder pattern
  - `finderColor` string: Finder pattern color as hex
  - `cornerMode` 'individual' | 'merge': Corner module rendering mode
  - `labelText` string: Optional text label rendered with the QR code
  - `labelStyle` 'below' | 'pill' | 'box': Label visual style
  - `labelColor` string: Label text color as hex
  - `labelBgColor` string: Label background color as hex
  - `labelFontSize` number: Label font size in pixels
  - `labelFontFamily` string: Label font family name

## Response `200`

Default Response

---

[API](https://skmtc.dev/short/apis/short-io-api-2.md) · [All operations](https://skmtc.dev/short/apis/short-io-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/short/apis/short-io-api-2/revisions/9e4e60c560b1?raw)