> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scanova.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Phone Number QR Code

> Create a QR code that dials a phone number.

## What it's for

A Phone Number QR code opens the device's dialer with a number already filled in, so scanning it is a one-tap way to call a business, support line, or contact. It's a **Quick Code** — a direct-action QR with no landing page.

<Note>
  In the app, this type's tile and page title read **"Phone Call"** rather than "Phone Number" — the underlying category (and this page) still calls it Phone Number, matching the `name` returned for this category by the `/qr/category/` API endpoint.
</Note>

<Note>
  Phone Number is **Static only** — there's no Dynamic option for this type. Once published, the encoded number can't be edited or tracked; to change it, create a new QR code.
</Note>

## Create a Phone Number QR code

<Steps>
  <Step title="Open Create QR Code and choose Quick Code">
    From the sidebar, go to **QR Codes**, then click **Create QR Code** (or navigate to `/qr/create`). Click the **Quick Code** card.
  </Step>

  <Step title="Pick Phone Call">
    On the **Quick Code** type grid, click **Configure** under **Phone Call**, in the **Static Only** section — described there as "Open the dialer pre-filled with your number." This opens the form at `/qr/quick/phone`.
  </Step>

  <Step title="Enter the phone number">
    Type the number into the single **Phone number** field (placeholder: `+1 415 555 0100`). This is the only field on the form and is required to publish.

    The field is validated on blur: it accepts digits, spaces, parentheses, dashes, and an optional leading `+`, and needs between 6 and 15 digits overall (matching the E.164 maximum length). An entry like `123` fails with **"Please enter a valid phone number."**

    <Frame caption="An invalid phone number showing the inline validation error">
      <img src="https://mintcdn.com/scanova-api/q8t3kzcRTgAP7jV0/images/v2/qr-codes/create/phone-number/phone-number-validation-error.png?fit=max&auto=format&n=q8t3kzcRTgAP7jV0&q=85&s=9614634b21ac100a876329af7b3c9b73" alt="Phone Call Quick Code form showing the phone number field with the value 123, highlighted red, and the error message Please enter a valid phone number below it" width="1440" height="900" data-path="images/v2/qr-codes/create/phone-number/phone-number-validation-error.png" />
    </Frame>

    <Frame caption="The Phone Call Quick Code form with a valid number entered">
      <img src="https://mintcdn.com/scanova-api/q8t3kzcRTgAP7jV0/images/v2/qr-codes/create/phone-number/phone-number-form-filled.png?fit=max&auto=format&n=q8t3kzcRTgAP7jV0&q=85&s=34231c948a14c0a22ac76ed6bd4234ff" alt="Phone Call Quick Code form with the phone number field filled in with +1 415 555 0142 and a live QR preview shown on the right" width="1440" height="900" data-path="images/v2/qr-codes/create/phone-number/phone-number-form-filled.png" />
    </Frame>
  </Step>

  <Step title="Publish">
    Click **Publish**. A panel opens to confirm or rename the QR code (it defaults to "Call \<number>"), assign a folder or tags, and adjust QR design before confirming.
  </Step>
</Steps>

## Creating one via the API

To create a Phone Number QR code through the API rather than the UI, use category ID `4` (labeled **Phone Number**, `allowed_qr_types: "st"` — only `"st"` is valid for `qr_type`), with an `info` payload shaped like:

```json theme={null}
{
  "type": "phoneNumber",
  "data": {
    "number": "+14155550142"
  }
}
```

The backend accepts any string for `number` (no format validation server-side) — the phone-format check described above is client-side only, to guarantee scanning devices can actually dial the result. See [Create QR Code](/v1/api-reference/endpoint/qr_manager/create) for the full request schema.

<Note>
  The [Category List](/v1/api-reference/references/category-list) reference table doesn't currently list Phone Number (or the other Quick Code–only categories on this page) — the ID above was confirmed directly against the live `/qr/category/` endpoint.
</Note>

## Related

* [Text Message QR Code](/qr-codes/create/text-message) — uses the same phone-number validation to pre-fill an SMS instead of a call.
* [Creating your first QR code](/getting-started/first-qr-code) — a full walkthrough of the Quick Code flow this type belongs to.
* [Folders, tags & bulk operations](/qr-codes/manage/folders-tags-bulk-operations) — organize the QR code after publishing it.