Tell your AI assistant to make the QR code. It shows up in your account.

Try asking your assistant: “Make a QR code for our spring open house that goes to our listings page, in navy on a transparent background.” Then, after the event: “Point the open house code at our thank-you page.”

1. 1

   Be on a Pro or Business plan

   The API is not included on the Free plan. See plans.
2. 2

   Open Settings, then API Keys

   Sign in to Leadible and go to Settings › API Keys.
3. 3

   Name your key and click Create key

   Use a name that tells you where it lives, like “ChatGPT” or “Make”. Each tool should get its own key.
4. 4

   Copy the key right away

   Your key starts with lk_live_. Leadible shows it once. Save it in your password manager, then paste it into the tool you are connecting.

Send your key in the Authorization header of every request. All requests use HTTPS and JSON.

Authorization: Bearer YOUR_API_KEY

Base URL: https://leadible.app/api/v1
Machine-readable description (OpenAPI 3.1): https://leadible.app/api/v1/openapi.json

curl -X POST https://leadible.app/api/v1/qr-codes \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Spring Expo Booth",
    "destination_url": "https://example.com/expo",
    "foreground_color": "#006B7D",
    "transparent_background": true
  }'

{
  "id": "3f9c2a1e-5b7d-4c8e-9a10-2b3c4d5e6f70",
  "name": "Spring Expo Booth",
  "short_code": "k7m2xq9p",
  "scan_url": "https://leadible.app/r/k7m2xq9p",
  "destination_url": "https://example.com/expo",
  "foreground_color": "#006B7D",
  "background_color": "transparent",
  "error_correction": "M",
  "dot_style": "square",
  "is_active": true,
  "scan_count": 0,
  "unique_scan_count": 0,
  "image": {
    "png": "https://leadible.app/api/v1/qr-images/k7m2xq9p.png",
    "svg": "https://leadible.app/api/v1/qr-images/k7m2xq9p.svg"
  },
  "created_at": "2026-11-05T15:00:00.000Z",
  "updated_at": "2026-11-05T15:00:00.000Z",
  "warnings": []
}

curl -X PATCH https://leadible.app/api/v1/qr-codes/3f9c2a1e-5b7d-4c8e-9a10-2b3c4d5e6f70 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "destination_url": "https://example.com/thank-you" }'

curl "https://leadible.app/api/v1/qr-codes?limit=25" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "items": [ { "id": "3f9c2a1e-...", "name": "Spring Expo Booth", "...": "..." } ],
  "next_cursor": null
}

curl https://leadible.app/api/v1/qr-codes/3f9c2a1e-5b7d-4c8e-9a10-2b3c4d5e6f70 \
  -H "Authorization: Bearer YOUR_API_KEY"

curl "https://leadible.app/api/v1/qr-codes/3f9c2a1e-5b7d-4c8e-9a10-2b3c4d5e6f70/analytics?days=30" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "total_scans": 412,
  "unique_scans": 288,
  "window_days": 30,
  "last_scanned_at": "2026-11-04T18:22:10.000Z",
  "daily": [ { "date": "2026-11-04", "scans": 37 } ],
  "top_countries": [ { "country": "US", "scans": 301 } ],
  "devices": { "mobile": 350, "desktop": 48, "tablet": 14 }
}

Image links such as /qr-images/k7m2xq9p.png need no key, so you can paste them into Canva, an email, or a print order. Add ?size=512 to pick a width from 128 to 2048 pixels (default 1024). The image only contains your scan link, so sharing it is safe.

Use these fields when you create or update a code. Unknown fields are rejected so typos never go unnoticed.

name

Required to create · text

1 to 100 characters. Only you see it.

destination_url

Required to create · link

Where people land after scanning. Must start with http:// or https://.

foreground_color

Optional · hex color

Dot color, like #1A2B3C. Defaults to black.

background_color

Optional · hex color

Defaults to white.

transparent_background

Optional · true / false

Use true to drop the background so the code sits on your design.

error_correction

Optional · L, M, Q, or H

Higher levels still scan when part of the code is covered or damaged. Defaults to M.

dot_style

Optional · text

square, dots, rounded, classy, classy-rounded, or extra-rounded. Shown in your dashboard downloads. Image links always use square dots.

is_active

Update only · true / false

Use false to pause a code. Paused codes send people to the Leadible homepage.

If your colors are too close together to scan reliably, the response includes a note in warnings. The code is still saved so you can adjust it.

The scan_url is the link inside the QR code. Changing destination_url never changes it, so printed codes keep working. If you set up a branded subdomain in Leadible, your scan links use it automatically.

Daily limits reset at 00:00 UTC and are shared by all keys on your account. Every response tells you where you stand:

X-RateLimit-Limit: 500
X-RateLimit-Remaining: 482
X-RateLimit-Reset: 1793923200   (Unix time of the next reset)
Retry-After: 3600               (only when you hit the limit)

Codes you create through the API count toward the same QR code total as codes you make in the dashboard.

Errors always come back in the same shape, so your tool can explain what went wrong:

{
  "error": {
    "code": "validation_error",
    "message": "must be a 6-digit hex color like #1A2B3C",
    "field": "foreground_color"
  }
}

• Treat your key like a password. Anyone who has it can create codes and change where your codes point.
• Give each tool its own key. If one leaks, revoke just that one and everything else keeps working.
• Never paste a key into a public GPT, a shared document, a screenshot, or website code that visitors can see.
• You can have up to 5 active keys. Settings › API Keys shows when each key was last used and your recent requests.
• Revoking a key stops it immediately. Leadible stores only a fingerprint of your key, so we cannot show it to you again.