Postman Guide
Go to Postman v1
  • 🥳About Postman v1 (Postman Legacy)
  • Campaign Guide - General
    • 🚀How to send a campaign?
      • ☝️Before You Start
        • Demo Mode
  • Campaign Guide - Email
    • 📧Email Campaigns - Basics
      • How do I send an email campaign?
      • Scheduled Sending
      • Bounced Emails and Halted Campaigns
      • Email Statistics
      • Formatting your Message Template
      • Variable Fields
      • Unique URL Link per Recipient
      • Pasting Content from Microsoft Word
      • Manage your Unsubscriptions
      • Understanding Unsubscriptions
    • 🔐Sending Password-Protected Emails
      • Tutorial
      • Template Editor
  • Campaign Guide - SMS
    • 📲SMS Campaigns - Basics
      • Before Starting Out
      • Summary of Costs
    • 🪜SMS Onboarding Overview
      • Step 1: Sender ID Registration
      • Step 2: Sign up for a Twilio account
      • Step 3: Set up your Twilio account
      • Step 4: Configure Your Twilio Account
        • What if I need to buy a phone number?
      • Step 5: Send a Test Message on Twilio
      • Step 6: Fill in your Twilio credentials in Postman!
        • How do I send a campaign with my saved SMS credentials?
    • 🤔What else do I need to know about sending SMSes?
      • More about Sender ID registration
      • Can I see the send status of my campaign?
      • How can I configure my SMS send rate?
      • Sending an SMS to a Foreign Number
      • SMS Best Practices
      • Useful Twilio Links
  • Campaign Guide - Telegram
    • 🤖Telegram Campaigns - Basics
      • How do I set up Telegram to send my campaigns?
      • Add Telegram Bot Token in Postman
      • Instructions for Recipient Onboarding
      • Use the Bot in the Campaign
      • Telegram Formatting
      • Telegram Bot Statistics
  • Email API Guide
    • 📖Overview
      • IM8 Policies
      • Connecting your Intranet Application
      • API Response Formats
    • 🗝️Email API Key Management
      • Bearer Authentication
      • Generate your email API Key
      • Rotate your email API Key
    • 📨Programmatic Email API
      • Getting Started
      • Comparison with AMR
      • SG-Mail Whitelisting
      • Custom From Address
      • Tracking Email Status
      • Send Email API
        • From Name and From Address
        • CC and BCC
        • Recipient Blacklist
        • Email Tagging and Classification
        • Email Body
          • Embedding Images
            • Linked Images
            • Content-ID Images
        • Attachments
        • Rate Limit
      • Get Email by ID API
      • List Emails API
    • 📨Programmatic GovSG WhatsApp API
      • Getting Started
      • Tracking Message Status
      • Get Available Templates API
      • Send Message API
      • Get Message by ID API
      • List Messages API
    • 🎓Frequently Asked Questions
  • FAQ
    • 📶Service Status
    • For Recipients
      • Check Email Authenticity
    • For Senders
      • Messaging Channel Comparison
      • Cost Breakdown
  • Legal
    • Terms & Conditions
    • Privacy Policy
  • Contact Us
  • GitHub
Powered by GitBook
On this page
  • Supported Image Formats
  • Linked images vs Content-ID images
  • Advantages of linked images
  • Advantages of content-ID images
  • More Info
  • How About Base64-Encoded Images?

Was this helpful?

  1. Email API Guide
  2. Programmatic Email API
  3. Send Email API
  4. Email Body

Embedding Images

PreviousEmail BodyNextLinked Images

Last updated 8 months ago

Was this helpful?

Supported Image Formats

Our API supports embedding images within the body of your email using the following methods:

  1. - this is the recommended, modern method for including images in your email.

  2. - we have built this as a fallback for legacy applications that are unable to host images on the Internet; this could also be used for images that are dynamically generated by your application.

Note that this is distinct from attaching an image to an email, which will typically require your recipient to click on the attachment to view the full-size image. For more information on attachments, . In contrast, embedded images are displayed within the body of your emails.

Linked images vs Content-ID images

Advantages of linked images

  • Emails are smaller in size as the image are hosted on a server elsewhere

  • Better support by email clients

  • Doesn't count towards the limit on the number of attachments an email can have

Advantages of content-ID images

  • Images exist entirely within the email; API user do not need to host the image separately

  • Intranet recipients do not need to connect to the Internet to see the image

More Info

How About Base64-Encoded Images?

We do not officially support base64-encoded images for the following reasons:

  • Popular email clients like Gmail do not support base64-encoded images and your recipients will not be able to see the images.

For more information, see the section on and respectively.

Emails with base64-encoded images are significantly larger, are more likely to be clipped by email clients (for more information, ) take longer to send, and are more likely to be marked as spam.

If your use case requires dynamically generated images and you are unable to host your own images on the Internet, we recommend that you look into as a replacement for base64-encoded images.

While we do not officially support base64-encoded images, we do not prevent you from sending them. If you choose to do so, please note that you have to stay within the .

📨
Linked images
Content-ID images
see here
linked images
content-ID images
Content-ID images
see here
email size limit