WhatsApp Personalized Images: API Guide (2026)

WhatsApp messages get 95-98% open rates. Email gets 8-20%. That's not a small difference. It's a different category of engagement entirely.

Now combine those open rates with personalized images, a promotional graphic with the customer's name, their specific offer, and the product they browsed, and you've got one of the most effective marketing channels available in 2026.

Here's how to set it up with an image generation API and WhatsApp Business API. All stats and pricing verified as of March 2026. If you're new to image APIs, start with our beginner guide.

Why personalized images on whatsapp workWhy Personalized Images on WhatsApp Work

The numbers tell the story:

Sources: yCloud, Chatarmin

A text-only WhatsApp message already outperforms email. Add a personalized image, one that shows the customer's name, a product they looked at, and a discount just for them, and the engagement jumps further. The image makes the message feel crafted, not mass-sent.

The technical workflowThe Technical Workflow

Here's the end-to-end pipeline. It's simpler than it sounds.

Step 1 set up whatsapp business apiStep 1: Set Up WhatsApp Business API

You need a WhatsApp Business Account with Cloud API access. The setup involves:

1. Create a Meta Business account
2. Verify your business
3. Register a phone number for WhatsApp
4. Get API credentials from the Meta Developer Dashboard

Most businesses use a WhatsApp Business Solution Provider (BSP) like Twilio, MessageBird, or Infobip to handle the API layer. Or you can use the Cloud API directly.

Step 2 create a message template with dynamic image headerStep 2: Create a Message Template with Dynamic Image Header

WhatsApp requires pre-approved templates for business-initiated messages. Create one with:

• Header: Image (dynamic, different URL per recipient)
• Body: Text with variables like "Hi {{1}}, your exclusive offer is here!"
• Footer: "Reply STOP to unsubscribe" (required for marketing)
• Button: "Shop Now" linking to your site

Submit for approval. Takes minutes to 48 hours.

Step 3 generate personalized images via apiStep 3: Generate Personalized Images via API

For each recipient, generate a unique image using Imejis.io:

curl -X POST 'https://render.imejis.io/v1/YOUR_TEMPLATE_ID' \
  -H 'dma-api-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "customer_name": {
      "text": "Sarah"
    },
    "offer": {
      "text": "25% OFF"
    },
    "product_image": {
      "image": "https://yourstore.com/products/sneaker-white.jpg"
    },
    "product_name": {
      "text": "Classic Runner"
    },
    "price": {
      "text": "$44.99"
    }
  }'

This returns a branded promotional image with Sarah's name, her offer, and the product she browsed. Under 2 seconds.

Step 4 send via whatsapp cloud apiStep 4: Send via WhatsApp Cloud API

Pass the generated image URL as the header component:

const response = await fetch(
  `https://graph.facebook.com/v18.0/${PHONE_NUMBER_ID}/messages`,
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${ACCESS_TOKEN}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      messaging_product: "whatsapp",
      to: customerPhone,
      type: "template",
      template: {
        name: "promo_with_image",
        language: { code: "en" },
        components: [
          {
            type: "header",
            parameters: [
              {
                type: "image",
                image: { link: generatedImageUrl },
              },
            ],
          },
          {
            type: "body",
            parameters: [
              {
                type: "text",
                text: "Sarah",
              },
            ],
          },
        ],
      },
    }),
  }
)

Each customer gets a unique image in their WhatsApp chat. Their name on it. Their product. Their offer.

Five use cases that convertFive Use Cases That Convert

1 personalized promotions1. Personalized Promotions

The highest-impact use case. Generate an image for each customer showing:

• Their name
• A product they browsed or purchased before
• A unique discount code or percentage
• A CTA button to the product page

With 95% open rates and 45-60% CTR, even a 1,000-person campaign drives serious traffic.

2 abandoned cart recovery2. Abandoned Cart Recovery

WhatsApp abandoned cart messages convert at 26-33% (vs 7-11% for email). Include a personalized image of the exact product left in cart, with the price and a "Complete Your Order" CTA. The visual reminder is more effective than a text-only nudge.

3 event invitations3. Event Invitations

Branded invitation images with the recipient's name, event details, and an RSVP button. Works for store openings, product launches, webinars, and exclusive events. The personalization makes it feel like a personal invitation, not a blast.

4 loyalty rewards4. Loyalty Rewards

Show customers their points balance, tier status, and available rewards in a branded image. "Sarah, you've earned 500 points! Here's what you can redeem." Visual loyalty updates feel more tangible than text.

5 order confirmations with upsells5. Order Confirmations with Upsells

Confirm the order with a product image, then include a cross-sell recommendation below: "Customers who bought this also loved..." Generated dynamically from your recommendation engine.

6 healthcare travel reminders6. Healthcare & Travel Reminders

Healthcare providers send appointment reminder images via WhatsApp with the patient's name, doctor, date, and clinic location. Travel companies send booking confirmation visuals with hotel photos, check-in dates, and reservation details. Both convert better than plain text.

Image specs for whatsappImage Specs for WhatsApp

Get these right or your images won't look good in chat:

Design your Imejis.io template at 1200x628 (1.91:1 ratio) for the best display in WhatsApp chat previews. Other ratios work but require the user to tap to view full-screen.

Important restrictionsImportant Restrictions

Before you build this, know the rules:

US market is blocked. Since April 2025, Meta doesn't allow marketing templates to US (+1) phone numbers. This works for markets in Europe, Asia, Latin America, Africa, and the Middle East. Not the US.

Opt-in is mandatory. Customers must actively consent to receive marketing messages. You can't just import a contact list and start sending.

Quality matters. WhatsApp tracks engagement. If recipients ignore or block your messages, your template quality rating drops. Too low and your templates get suspended. No warnings since April 2025.

Per-message pricing. WhatsApp charges per marketing message: roughly $0.02 (India) to $0.22 (Germany). Image generation adds $0.0025-$0.015 per image via Imejis.io. Factor both costs into your campaign ROI.

Automation with no code toolsAutomation with No-Code Tools

You don't need to write the code above yourself. Here's the no-code path:

1. Trigger: New row in Google Sheets/Airtable (your campaign list)
2. Step 1 (Make/n8n): Call Imejis.io API with customer data to generate the personalized image
3. Step 2 (Make/n8n): Send the image via WhatsApp Cloud API (or through a BSP like Twilio)
4. Result: Each customer gets a personalized image in their WhatsApp, fully automated

Both Make.com and n8n have WhatsApp Cloud API integrations built in. You can also use Zapier for a similar no-code setup.

Getting startedGetting Started

1. Sign up for Imejis.io with 100 free image generations per month
2. Design a promotional template at 1200x628 with dynamic fields for name, offer, and product
3. Test with 5-10 contacts to validate the workflow end-to-end
4. Set up your WhatsApp Business account and create an approved message template
5. Connect the pipeline via Make, n8n, or custom code
6. Launch your first campaign and monitor engagement metrics

For image API pricing across providers, see our Image Generation API Pricing Comparison. For other personalization use cases, check our Dynamic Product Images, Email marketing image personalization, and Testimonial Images guides. Targeting multiple markets? See our multi-language image generation tutorial. Building a native app? Check out mobile app image generation.

FaqFAQ

Can i send personalized images via whatsapp business apiCan I send personalized images via WhatsApp Business API?

Yes. WhatsApp templates support dynamic image headers. Generate a unique image per recipient with Imejis.io, then pass the URL when sending via WhatsApp Cloud API.

What image format does whatsapp supportWhat image format does WhatsApp support?

JPEG or PNG, 8-bit RGB/RGBA, max 5 MB. Best display at 1.91:1 aspect ratio (1200x628). URLs must be direct links.

How much does whatsapp marketing costHow much does WhatsApp marketing cost?

WhatsApp charges ~$0.02-$0.22 per marketing message depending on country. Image generation adds $0.0025-$0.015 per image. Combined cost is still well below the engagement value given 95%+ open rates.

Is whatsapp marketing allowed in the usIs WhatsApp marketing allowed in the US?

No. Since April 2025, Meta blocks marketing templates to US phone numbers. Only transactional and support messages are allowed for US recipients.

What are whatsapp open rates vs emailWhat are WhatsApp open rates vs email?

WhatsApp: 95-98% open, 45-60% CTR. Email: 8-20% open, 2-5% CTR. WhatsApp outperforms email by 5-12x on engagement.

Start sending personalized whatsapp imagesStart Sending Personalized WhatsApp Images

Your customers are on WhatsApp. Your product data is in a spreadsheet. The missing piece is the personalized image connecting them. Try Imejis.io free and generate your first batch today.