Understand every QR type before you publish

Smart Text — static or dynamic

Fill in the form: choose whether you want plain text or HTML content. Plain text is ideal for messages and notes. HTML is ideal for branded layouts, headings, buttons, images, and supported video embeds.

<div style="max-width:760px;margin:0 auto;">
    <h2 style="margin:0 0 12px;text-align:center;font-size:28px;color:#0f172a;">Welcome to Arynox QR Training</h2>
    <p style="margin:0 0 20px;text-align:center;font-size:16px;line-height:1.7;color:#475569;">
        Watch the short video below and review the key points underneath.
    </p>

    <div style="margin:0 0 20px;border-radius:18px;overflow:hidden;background:#000;">
        <div style="position:relative;padding-top:56.25%;">
            <iframe
                src="https://www.youtube.com/embed/66ofNbEV_Gk"
                title="Arynox QR Video"
                allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share"
                allowfullscreen
                loading="lazy"
                referrerpolicy="strict-origin-when-cross-origin"
                style="position:absolute;top:0;left:0;width:100%;height:100%;border:0;">
            </iframe>
        </div>
    </div>

    <div style="border:1px solid #dbe7f5;border-radius:18px;padding:20px;background:#f8fafc;">
        <h3 style="margin:0 0 12px;font-size:20px;color:#0f172a;">Key Information</h3>
        <p style="margin:0 0 10px;font-size:15px;line-height:1.7;color:#334155;">
            Use Smart Text HTML for branded welcome pages, training, onboarding, and guided instructions.
        </p>
        <ul style="margin:0;padding-left:20px;font-size:15px;line-height:1.8;color:#334155;">
            <li>Embed a YouTube video or hosted MP4</li>
            <li>Add text, headings, links, and images</li>
            <li>Keep everything inside your branded QR page</li>
        </ul>
    </div>
</div>

Website URL — static or dynamic

Fill in the form: paste the final page address, ideally with https://.

Email Message — static or dynamic

Fill in the form: enter the recipient email address, subject, and optional message. The platform turns that into a mailto: link automatically.

Phone Call — static or dynamic

Fill in the form: enter the number people should call. The platform converts it into a tel: link.

SMS Message — static or dynamic

Fill in the form: enter the phone number and optional SMS text. The platform converts it into an SMS-ready code.

Contact Card (vCard) — static or dynamic

Fill in the form: add the person or business details you want visitors to save to their contacts. The platform converts that into a full vCard block.

WhatsApp Chat — static or dynamic

Fill in the form: enter the WhatsApp number and optional message. The platform builds the chat link automatically.

Map Location — static or dynamic

Fill in the form: enter either a full address or coordinates. Arynox builds the map link for you.

Event Details — static or dynamic

Fill in the form: enter the event title, start, end, location, and optional description. Arynox creates the calendar destination for you.

Wi-Fi Access — static only

Fill in the form: enter the network name, security type, password, and hidden setting if needed. Arynox converts that into the raw Wi-Fi payload phones expect.

App Link — best in dynamic

Fill in the form: add the iPhone link, Android link, and fallback link. In static mode the QR always uses the fallback link. Dynamic mode is the one that can recognize device type and route people properly.

Hosted File / Media — static or dynamic

Fill in the form: upload your file, choose a title, and decide whether it should display in the browser or download directly. Arynox stores the file in your private hosted storage area.

Example: Smart Text HTML with YouTube video

Paste HTML like this into the Smart Text HTML editor:

Example: Smart Text HTML with remote MP4 video

Use a direct public HTTPS video file URL like this:

Builder styling options

• Body gradient: blends your QR body between a start color and end color
• Gradient direction: choose top left → bottom right, top right → bottom left, top → bottom, left → right, or circular / radial
• Dots style: square, rounded, classy, classy-rounded, dots, or extra-rounded depending on the selected style set
• Corner styles: control the visual style of the corner squares and corner dots without changing your QR content
• Logo: place a centered image on the code for branding, but keep it modest and test scans before publishing

Gradient directions

Supported builder directions
- tl-br   = top left → bottom right
- tr-bl   = top right → bottom left
- top-bottom = top → bottom
- left-right = left → right
- radial  = circular / radial
- gradient_balance = soften and shift the transition line from -45 to 45

The gradient direction affects the QR body fill only. It does not change the outer frame border or the QR border.

Logo sizing guidance

Keep logos modest even though the platform allows a wider range. The current hard platform range is 0.05 to 0.32 of the QR size, with 0.22 commonly used as a default in existing records.

For best scan reliability, use practical sizes closer to the middle of that range and always test on more than one phone before launch.

What the API is for

• Create one QR at a time from external systems
• Bulk-create many QRs for rooms, tables, products, campaigns, sites, or labels
• Generate Smart Text and Smart Text HTML pages programmatically
• Apply colors, style options, and logos
• Read QR lists and analytics from external software

Base URL and authentication

Base URL example
https://qr.arynox.com

Header
Authorization: Bearer YOUR_API_KEY

API keys are generated from the account API page when your plan includes API access.

Available endpoints

GET  /api/docs
GET  /api/v1/account
GET  /api/v1/styles
GET  /api/v1/qrs
GET  /api/v1/qr?id=123
GET  /api/v1/qrs/analytics?id=123
POST /api/v1/assets/logo/upload
POST /api/v1/qrs/create
POST /api/v1/qrs/bulk-create
POST /api/v1/qrs/update
POST /api/v1/qrs/delete

Example: create one website QR

{
  "name": "API Test QR",
  "content_type": "url",
  "qr_type": "static",
  "url": "https://example.com"
}

Example: create one Smart Text QR

{
  "name": "Reception instructions",
  "content_type": "text",
  "qr_type": "dynamic",
  "text_format": "text",
  "text": "Welcome to Arynox. Please check in at reception."
}

Example: create one Smart Text HTML QR

{
  "name": "Welcome training page",
  "content_type": "text",
  "qr_type": "dynamic",
  "text_format": "html",
  "text": "<h2>Welcome</h2><p>Watch the training video below.</p>"
}

Example: styled QR payload

{
  "name": "Styled campaign QR",
  "content_type": "url",
  "qr_type": "static",
  "url": "https://example.com/campaign",
  "size": 300,
  "margin": 8,
  "dots_style": "square",
  "corners_square_style": "square",
  "corners_dot_style": "square",
  "foreground_color": "#000000",
  "background_color": "#ffffff"
}

Example: gradient and logo styling payload

{
  "name": "Gradient campaign QR",
  "content_type": "url",
  "qr_type": "static",
  "url": "https://example.com/campaign",
  "shape_gradient": true,
  "gradient_start": "#14B8A6",
  "gradient_end": "#5B7CFF",
  "gradient_direction": "tr-bl",
  "gradient_balance": -10,
  "logo_preset": "scan-text",
  "logo_text": "SCAN",
  "dots_style": "rounded",
  "corners_square_style": "extra-rounded",
  "corners_dot_style": "dot",
  "logo_size": 0.22,
  "logo_padding": 14
}

Supported gradient_direction values in the current build are tl-br, tr-bl, top-bottom, left-right, and radial. Use gradient_balance to soften and shift the transition line between the two colors. Predefined logos now include Stripe, PayPal, Bitcoin, WhatsApp, Telegram, WeChat, Messenger, Scan Me, and Scan Text.

Logo upload and reuse

• Upload by multipart file
• Upload by data URI
• Upload by remote public logo URL
• Use modest logo sizes so codes remain easily scannable

Bulk creation

{
  "items": [
    {
      "name": "Room 101",
      "content_type": "url",
      "qr_type": "static",
      "url": "https://example.com/rooms/101"
    },
    {
      "name": "Room 102",
      "content_type": "url",
      "qr_type": "static",
      "url": "https://example.com/rooms/102"
    }
  ]
}

Bulk creation is ideal for hospitality, inventory, real estate, table service, events, and internal rollout campaigns.

Validation and rejection rules

• Dynamic Wi-Fi is rejected because Wi-Fi must be static
• Missing required fields return a validation error
• Unsupported style values are rejected
• API access is blocked if the plan does not include API
• Requests above allowed bulk size are rejected

Rejected example
{
  "name": "Invalid WiFi Test",
  "content_type": "wifi",
  "qr_type": "dynamic",
  "ssid": "GuestWiFi",
  "security": "WPA",
  "password": "StrongPassword123"
}

PowerShell test example

$ApiKey = "YOUR_REAL_API_KEY"
$Headers = @{
    Authorization  = "Bearer $ApiKey"
    Accept         = "application/json"
    "Content-Type" = "application/json"
}

$Body = @{
    name         = "My First API QR"
    content_type = "url"
    qr_type      = "static"
    url          = "https://example.com"
} | ConvertTo-Json -Depth 10

Invoke-RestMethod `
    -Uri "https://qr.arynox.com/api/v1/qrs/create" `
    -Method Post `
    -Headers $Headers `
    -Body $Body

Can Smart Text show HTML instead of only plain text?

Yes. Smart Text supports both Plain Text and HTML Content. HTML mode lets you create a richer branded content experience inside the hosted Smart Text page.

Can Smart Text HTML include video?

Yes. Supported embed formats include YouTube iframe embeds and direct public HTTPS video files such as MP4 in a video tag.

Can static App Link recognize the device?

No. Static App Link always uses the fallback link. Device recognition and platform routing are only available in dynamic mode.

Do I need to type mailto:, tel:, or SMSTO: myself?

No. Fill in the normal form fields and Arynox generates the technical QR value for you automatically.

Which types are strongest in static mode?

Wi-Fi, direct phone actions, SMS, email actions, and other direct raw payload cases are the strongest static cases.