Level Up Your Branding: How to Generate Custom QR Codes at Scale with the EagleBirth API

Tired of using generic, square black QR codes that clash with your branding? The EagleBirth QR Code Generator API is built to turn that functional square into a fully branded, recognizable marketing asset.

Want to see the styles first? You can design and preview our 50+ styles instantly at our Live Preview Tool.

This guide will walk you through setting up your first API call to generate a high-quality, customized QR code complete with custom colors, unique patterns, and your company logo embedded right in the center.

1. Prerequisites: Get Your Access Token

To use the EagleBirth API, all requests must be authenticated using a Bearer Token.

1. Sign Up & Create an App: After signing up for your free account, navigate to the Apps section and create a new project. This secures your usage and begins your allocation of 1,000 free functional QR code generations per month!
2. Get Your Token: Follow the App Authentication documentation to exchange your Client ID and Secret for the necessary Access Token.

Once you have your token, you’re ready to make calls.

For complete setup instructions, refer to the Official API Documentation.

2. Generating Your First Branded QR Code

The EagleBirth QR Code API uses a simple POST request. For this example, we will use Python to demonstrate how easily you can customize your output.

API Endpoint: https://eaglebirth.com/api/app/qr_code_generator/

In the payload, we’ll define the data, colors, and the custom style.

Python

import requests

url = "https://eaglebirth.com/api/app/qr_code_generator/"
payload = {
    "text": "https://yourwebsite.com/promotion-link", # REQUIRED: The data to encode
    "color": "#1E3A8A", # A deep indigo color
    "background_color": "#F0F9FF", # A light blue background
    "qr_type": "circle__rounded", # Our custom pattern style
    "image_type": "link", 
    "image": "https://example.com/your-logo-public-url.png" # Link to your logo
}
headers = {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN"
}

response = requests.post(url, data=payload, headers=headers)
print(response.json())

3. Deep Dive into Customization Parameters

The power of the EagleBirth API lies in its optional, yet impactful, parameters:

Parameter	Type	Purpose
text	string (Required)	The data (URL, text, etc.) the QR code should encode.
color	hex	Sets the foreground color (e.g., #000000).
background_color	hex	Sets the background color (e.g., #ffffff).
image / image_type	file / string	Used to embed a logo in the center. Use image_type: 'link' if you provide a public URL for the logo, or image_type: 'image' if you are uploading the logo file directly.
qr_type	string	The style of the QR patterns. This is where the magic happens!

4. Unleash 50+ Unique Styles

The qr_type parameter allows you to choose from an impressive array of visual patterns, going far beyond the default square dots. You can combine different shapes for the main data dots and the corner eyes.

Some examples you can try:

• circle__rounded
• gapped_square__horizontal
• custom_eye__vertical
• gradiant_radial

Refer to the official documentation for a complete visual grid of all available IDs. By simply changing this one string, you can completely overhaul your QR code’s look.

5. The Output: Secure and Instant Embed

The API provides two incredibly convenient fields in the JSON response:

JSON

{
  "res": "success",
  "data": "data:image/png;base64,iVBORw0KGgo...",
  "embed_code": "<img src='https://assets.eaglebirth.com/qr/render/?token=...' alt='QR Code' width='250' />"
}

The most powerful field is embed_code. This secure, signed HTML string contains a link that you can drop directly onto any website. You never have to worry about hosting the QR code image yourself.

The API manages security, image hosting, and dynamic rendering, ensuring your custom-branded code works flawlessly and instantly across your entire marketing stack.

---

Ready to generate beautiful, functional QR codes? Sign up today to access the API and start generating your first 1,000 free codes!