Bannerify Docs
Search docs.../
DiscordDashboard
DocumentationAPI ReferenceSDK
Navigation
DocumentationAPI ReferenceSDK

Essentials

Recipes for common jobs

Learn how to build the template and the request for jobs such as social cards, product banners, certificates, invoices, shipping labels, and tickets.

Each recipe lists the layers to add to a template and the request that fills them. The steps are the same every time:

  1. Add the layers in the table and give each one its name, as in Name your layers.
  2. Save the template and copy its id with Copy Template ID on its card.
  3. Send the request. Replace YOUR_API_KEY with a key from the API Keys page, and replace the template id with yours.

Social card

A social card shows a headline and an author on a picture of a fixed size. It suits blog posts and link previews. For the canvas, choose Open Graph (1200 by 630 pixels) under the social presets.

Layer name Layer Request field
title Text text
author Text text
avatar Image src 
curl --request POST \
  --url https://api.bannerify.co/v1/templates/createImage \
  --header 'Content-Type: application/json' \
  --output card.jpg \
  --data '{
    "apiKey": "YOUR_API_KEY",
    "templateId": "tpl_social_card",
    "format": "jpeg",
    "quality": 85,
    "modifications": [
      { "name": "title", "text": "How we cut render time in half" },
      { "name": "author", "text": "An Nguyen" },
      { "name": "avatar", "src": "https://example.com/an.png" }
    ]
  }'

Titles vary in length, so make the title box tall enough for the longest one. Set Max lines in the Text fit section if you want a hard limit. To use the card in an Open Graph tag, build a signed URL for the same template and modifications.

Product banner

A product banner shows a photo, a name, and a price, and it can show a sale badge. For the canvas, choose Square (1080 by 1080 pixels).

Layer name Layer Request field
product-photo Image src
product-name Text text
price Text text
sale-badge Text visible

Write Sale in the sale-badge layer, add a background to it in the Background section so that it looks like a badge, and hide the layer with its eye in the Layers list. The request below shows the badge. For a product without a sale, leave sale-badge out of the request or set "visible": false.

curl --request POST \
  --url https://api.bannerify.co/v1/templates/createStoredImage \
  --header 'Content-Type: application/json' \
  --data '{
    "apiKey": "YOUR_API_KEY",
    "templateId": "tpl_product_banner",
    "modifications": [
      { "name": "product-photo", "src": "https://example.com/shoes.png" },
      { "name": "product-name", "text": "Trail runner" },
      { "name": "price", "text": "$89" },
      { "name": "sale-badge", "visible": true }
    ]
  }'

The response holds the address of the saved file:

{
  "url": "https://images.bannerify.co/files/0b3c1c1e-5d6f-4c52-9e0a-8f6a4c0f2a11.png"
}

Keep the url with the product so that you do not render the banner again. For a whole catalog, send one request for each product. Quota and limits lists how many requests a key can send.

Certificate

A certificate is a PDF with the name of a recipient, a course, a signer, and a QR code that links to a page where someone can check it. A PDF page has the size of the canvas in points, so set Size to 842 by 595 for an A4 page that is wider than it is tall.

Layer name Layer Request field
recipient Text text
course Text text
signature Signature text, title, date
verify QR Code qrcode 
curl --request POST \
  --url https://api.bannerify.co/v1/templates/createPdf \
  --header 'Content-Type: application/json' \
  --output certificate.pdf \
  --data '{
    "apiKey": "YOUR_API_KEY",
    "templateId": "tpl_certificate",
    "modifications": [
      { "name": "recipient", "text": "Mai Tran" },
      { "name": "course", "text": "Advanced image automation" },
      { "name": "signature", "text": "An Nguyen", "title": "Director", "date": "2026-02-02" },
      { "name": "verify", "qrcode": "https://example.com/certificates/1042" }
    ]
  }'

Invoice

An invoice is a PDF with a number, a customer, a table of line items, totals, and a payment note. Set Size to 595 by 842 for an A4 portrait page.

Layer name Layer Request field
invoice-number Text text
customer Text text
line-items Table columns, rows
totals Key Value rows
payment-note Alert title, text 
curl --request POST \
  --url https://api.bannerify.co/v1/templates/createPdf \
  --header 'Content-Type: application/json' \
  --output invoice.pdf \
  --data '{
    "apiKey": "YOUR_API_KEY",
    "templateId": "tpl_invoice",
    "modifications": [
      { "name": "invoice-number", "text": "INV-1042" },
      { "name": "customer", "text": "Acme Studio" },
      {
        "name": "line-items",
        "columns": ["Item", "Qty", "Total"],
        "rows": [
          { "Item": "Automate plan", "Qty": 1, "Total": "$29.00" },
          { "Item": "Extra seat", "Qty": 2, "Total": "$10.00" }
        ]
      },
      {
        "name": "totals",
        "rows": [
          { "key": "Subtotal", "value": "$39.00" },
          { "key": "Tax", "value": "$3.90" },
          { "key": "Total", "value": "$42.90" }
        ]
      },
      { "name": "payment-note", "title": "Payment terms", "text": "Pay before 31 Jan 2026." }
    ]
  }'

A table cuts the rows that run past the bottom of its box, and a PDF has one page. Make the table tall enough for the longest invoice you expect.

Shipping label

A shipping label shows an address, a service, and a barcode of the tracking number. A 4 by 6 inch label at 300 dpi is 1200 by 1800 pixels, so set Size to that and print the PNG at 300 dpi.

Layer name Layer Request field
ship-to Text text
service Text text
tracking-barcode Barcode barcode 
curl --request POST \
  --url https://api.bannerify.co/v1/templates/createImage \
  --header 'Content-Type: application/json' \
  --output label.png \
  --data '{
    "apiKey": "YOUR_API_KEY",
    "templateId": "tpl_shipping_label",
    "modifications": [
      { "name": "ship-to", "text": "Mai Tran\n12 Pine Street\nHanoi 100000" },
      { "name": "service", "text": "Express" },
      { "name": "tracking-barcode", "barcode": "1Z999AA10123456784" }
    ]
  }'

A new line in text starts a new line on the label, so ship-to can hold the whole address. The barcode prints its value under the bars, so the label needs no separate text layer for the number.

Ticket

A ticket shows an attendee, an event, and a QR code that a door scanner reads. Send the address or the code that your scanner expects as the QR code content.

Layer name Layer Request field
attendee Text text
event Text text
ticket-qr QR Code qrcode 
curl --request POST \
  --url https://api.bannerify.co/v1/templates/createStoredImage \
  --header 'Content-Type: application/json' \
  --data '{
    "apiKey": "YOUR_API_KEY",
    "templateId": "tpl_ticket",
    "modifications": [
      { "name": "attendee", "text": "Mai Tran" },
      { "name": "event", "text": "Image automation meetup" },
      { "name": "ticket-qr", "qrcode": "https://example.com/tickets/8f3a1c" }
    ]
  }'

The response holds the url of the saved image, which you can put in an email.