How can we help?

You need to generate the API key in MailBluster if you want to integrate your app/website with MailBluster.

To generate the API key, you need to go to your Brand > Settings > API Keys then click Create new.

Type the API key name and then click Create API key

Once the API key is generated, copy the Key value and use it with your app/website.

The default rate limit for MailBluster Developer API is 10 requests/second and 100 requests/minute.

Lead hash is the md5 encrypted value of lead’s email. To obtain the MD5 hash value of your lead’s email, you can use various MD5 generator tools available online. One such tool is located at MD5 Hash Generator. Simply input the email address of your lead into the tool, and it will generate the corresponding MD5 hash value, which is known as {lead_hash}

Then, you will need to send a GET request to read the specific lead to this API endpoint:  https://api.mailbluster.com/api/leads/{lead_hash}

Check out this guide: https://app.mailbluster.com/api-doc/leads/read.

Please note: Some technical knowledge is required to implement this technique.

A CORS error occurs when you make a request from an HTML form submission or an AJAX call. This happens because anyone can intercept the request and view the secret API key, which is why CORS restrictions exist.

If you are getting CORS errors, it means you are calling the MailBluster developer API directly from your frontend. Instead, you need to call the MailBluster developer API from your backend.

To resolve this, send the request from your backend using languages like PHP, Node.js, Python, Ruby, etc. You can test this with Postman or a similar API testing tool to ensure it works as expected.

Calling the MailBluster developer API from the frontend will not work due to CORS errors and the associated security risks. Exposing your API key publicly can lead to major security issues.

Always make API calls from your backend to keep your API key secure. This approach will prevent CORS errors and protect your API key from being exposed.

You cannot update multiple leads using MailBluster Developer API.
Only single lead can be added at a time. Same goes for update and delete while using the Developer API.

If you want to import more than one lead at a time, then you need to use the MailBluster main app.

Here is the API documentation for your assistance: https://app.mailbluster.com/api-doc.

MailBluster Developer API is not designed for sending and receiving emails, such as bulk emailing. However, it allows you to manage your leads, products, and e-commerce activities from outside your MailBluster account.

The API is specifically designed to control Leads, Fields, Products, and Orders. In simple terms, the Developer API is intended for collecting leads from the client’s website and managing related data. It is not capable of sending emails.

For further details on MailBluster Developer API, please visit: MailBluster API Documentation.

MailBluster by default, sends email at 90% rate. If a user requests to lower the send rate through support, then our Tech team can reduce it to 50%.

MailBluster can be connected to your Website Forms using these three ways:

1. Using MailBluster developer API

If you have website/application, you can use MailBluster developer API to connect MailBluster with your brand.

You need some technical knowledge to use the MailBluster Developer API.

For details, checkout MailBluster Developer API Documentation.

2. Using MailBluster WordPress Plugin.

If your app/website is built using WordPress, you can use MailBluster WordPress plugin to create a subscribe form and add it to your page/post. WordPress Plugin for MailBluster allows the site visitors to become subscribers through a subscribe form which will automatically add them to the MailBluster mailing list without doing anything manually.

The plugin can be installed to your WordPress site from https://wordpress.org/plugins/mailbluster4wp.

You can take the help from this guide How to connect and create WordPress Form using MailBluster WordPress Plugin.

For more details, you can also check this Blog How to Link your WordPress site with MailBluster.

3. Using MailBluster Forms

MailBluster forms allow you to collect lead data directly from your website and add it to your lead list. MailBluster offers two types of forms:

1. Inline Form: This form displays in a specific section of your website where you choose to place it. For instance, you can position it at the top, middle, or bottom of your site. The inline form is permanently displayed in the location you select.

2. Pop-up Form: This form appears as a pop-up while visitors browse your site. You can configure the pop-up’s timing and choose its position—left, center, or right—at the beginning, middle, or bottom of the page. The pop-up form will display based on your configuration, including position, frequency, and trigger conditions.

Both forms can be effective depending on your creation strategy, website layout, and marketing approach. However, to achieve success, it is crucial to create your form correctly. Here, MailBluster can be your best companion.

You can take the help from this guide How to embed your Form in WordPress.

For more details, you can also check this Blog MailBluster Forms for your Website: A Step-by-Step Guide.

If your app or website is built using WordPress, you can take advantage of the MailBluster WordPress plugin available here. Simply install it on your WordPress site.

The MailBluster WordPress Plugin provides basic functionality, such as the ability to create simple forms. These forms enable site visitors to easily subscribe, automatically adding them to your MailBluster mailing list without any manual intervention.

Please Note: The plugin and its basic forms are not designed for checkout and do not include e-commerce functionality.

For details on how to connect WooCommerce with MailBluster and perform e-commerce activities, please refer to the guide here.

The following are the guidelines on how to embed your created form using WordPress Custom HTML:

1. Go to the page where you want to embed your form.
2. Click on the Plus icon to add a new element.
3. Select Custom HTML.

4. Paste the HTML code from your MailBluster Form into the Custom HTML block.
5. Click Update in the top right corner.

You are now done. Your customized MailBluster form will appear on your WordPress website. This is how you can add the generated HTML code to your HTML website.

For further details, you can visit this Blog: MailBluster Forms For Your Website: A Step-by-Step Guide.

First you need to go to WordPress site and search for MailBluster for WordPress plugin.

Download the MailBluster for WordPress Plugin as shown below from here: https://wordpress.org/plugins/mailbluster4wp/.

Now signin to your WordPress website Admin panel and click on Plugins

Click on Add New Plugin.

Click on Upload Plugin button in WordPress Admin page.

Select Choose File button and insert a CSV extension file.

Select the downloaded zip file of the MailBluster Plugin.

Now, click Install Now button.

After the plugin installation is completed, click Activate Plugin button.

Now you need to configure MailBluster API key. Click on MailBluster API as shown below.

It will take you to the MailBluster API Key settings page where you need to insert the API Key to connect with the main MailBluster app.

Sign in to MailBluster, then go to your Brand > Settings >API Keys and then click Create new.

Now enter API key name, for example, API key for WordPress, and then click on Create API key.

API key value will be generated. You need to copy the key value of this API key.

Paste the API key value and click Save Changes.

Your MailBluster Brand is now connected to your website through this API Key. Make sure API Status remains Active. You will also notice which MailBluster Brand is connected to this API key.

Now click on Forms and click Add New button.

Write down the Form name, Description and Builder settings to edit the Form.

Here we are updating the field; we replaced it with ‘city’. Then click Save field.

Here we are deleting/removing the “credit card” field and adding another field. Click Delete field to delete any current field.

Now go to Forms and customize your form accordingly. Click Add New field Be sure to click Save Draft to save your progress.

Add a new Field Label ‘Gender,’ and its Field Merge Tag ‘gender’ will be generated automatically. Then click Add Field.

‘Gender’ field has been created. Click on Gender to add to Preview Panel. Now click Save Draft.

Click on the Messages tab to write your desired messages as shown below.

Click on the Appearance tab to change the design of the form. Hit Save Draft every time your change any settings.

Click on the Settings tab to enable Double Opt-in, show MailBluster branding, add a consent checkbox, and set a Redirect URL according to your needs. Be sure to click Save Draft to save your settings.

Now click on Forms, click Publish and the copy the MailBluster Shortcode as shown below.

Now go to Pages and select your desired WordPress page. Click Edit.

Click the ‘+‘ symbol and drag and drop the Shortcode [/] into the WordPress page editor.

Now paste the MailBluster Shortcode under this [/] Shortcode field.

Now click on the Preview button and select Preview in new tab.

You will now see the Form made by the MailBluster Plugin.

Fill up the form and then click Subscribe.

The confirmation message will appear as set in the configuration settings earlier.

Sign in to MailBluster > Brand and then go to Leads section. As you can see, the email ID, name, and subscription status are added to the MailBluster app from the WordPress Form page.

Yes, it is possible to connect WooCommerce with MailBluster using the WooCommerce Plugin, Bit Integrations Plugin and the MailBluster API key generated from the MailBluster app. You need to first install the WooCommerce Plugin to your WordPress site.

Then you need to install a 3rd party integration tool to your WordPress site called Bit Integrations Plugin.

Finally generate API key from MailBluster and connect Bit Integrations with MailBluster and WooCommerce.

Connecting MailBluster API with Bit Integrations.

A detailed guide on how to connect WooCommerce with MailBluster can be found here.

WooCommerce is a popular open-source e-commerce plugin for WordPress. It enables users to create and manage an online store with ease, leveraging the flexibility and functionality of the WordPress platform. In this guide, we will not discuss how to set up WordPress, as you already own a domain and have deployed your WordPress site. Instead, we will go through the detailed process of connecting WooCommerce with the MailBluster app.

First, you need to go to your WordPress Admin panel, then Plugins and click on Add New Plugin.

Type WooCommerce in the Keyword field. Then click on Install Now button.

After installation, click on Activate button.

The WooCommerce page will open, and you need to set up your WooCommerce store by following the wizard after clicking ‘Set up my store.’ We will not go into details on how to set up WooCommerce, as we are focusing on integrating MailBluster with WooCommerce. We assume that you have already set up your WooCommerce store.

After setting up WooCommerce store, you need to again go to your WordPress Admin panel. Then click on Plugins. Type bit integrations in the Keyword field. Then click on Install Now button.

We are using this 3rd party tool called Bit Integrations because it is designed to help users integrate and automate various software applications and services. It’s particularly useful for streamlining workflows by allowing different applications to communicate with each other and perform automated actions based on specific triggers.

After installation, click on Activate button.

A new option will appear on the left side of WordPress menu name Bit Integrations. Just click on it and then click on Create Integration.

Click on the Please select a Trigger field and type ‘Woo’. WooCommerce will appear. Click on the Woocommerce.

Now you have to Select a Form/Task Name from the dropdown list. Here we selected ‘Customer-Edit‘

After selecting Task Name, click the Next button.

Now you have to go to Bit Integrations again from the WordPress menu on the left side. Click on it and then Please select a Action field appears. Type ‘MailBluster‘ and click on MailBluster.

You will be asked to enter the API Token which you will need it from the MailBluster app.

Since we have discussed on how to create API key, here we are just showing how to obtain and copy the API key from MailBluster. Just go to your Brand > Settings > API Keys and copy the Key value of the API.

After copying the key value of the API Key, go to you previous WordPress Admin panel session and then Bit Integrations and paste the API Token as shown below. Click the Authorize button and then click Next button.

Select Type Subscribed and then highlight the Form Fields with MailBluster Fields from Field Map as shown below. Then click the Next button.

Bit Integrations will give a confirmation that the Integration has been successful. Click on Finish & Save.

Now go to your WooCommerce site and click on My Account > Account details. Enter the details as shown below and click Save changes. It will give a confirmation like ‘Subscribed successfully’.

Now go to WordPress Admin Panel of your website and then click Bit Integrations. Click on the 3 dot ellipsis and then click Timeline.

You will see the Integration log showing Status as ‘success‘ for the newly entered lead information earlier.

Now, if you go to MailBluster, then your Brand>Leads, you will notice that the lead information has been added to the Leads section from your WooCommerce Store site successfully.

MailBluster does have Gravity Forms integration option. The Gravity Forms Webhooks add-on allows you to send your form data from your WordPress website to an external app or service. You will find this guide very helpful while integrating the plugin into your website.

MailBluster doesn’t provide direct sync support for the Shopify website yet.

But you can integrate MailBluster into Shopify using these two ways:

1. Using MailBluster developer API (https://app.mailbluster.com/api-doc)
You need to customize Shopify to send the lead information to MailBluster using the developer API when a customer signs up to your store. You need to have the technical knowledge to do this or need help from a software developer.

2. Using Make (formerly Integromat).
You need to create a scenario on Make to connect Shopify with MailBluster.

For both Shopify and MailBluster, you need to create a new connection on Make that is not shown in the video. For MailBluster, you just need to create a new API key from Settings > API Keys page from MailBluster and provide the Key in Make.

You can use MailBluster with OpenCart using a 3rd party tool called Make (formerly known as Integromat). The following link will help you with connectivity and integration using MailBluster: https://www.make.com/en/integrations/mailbluster.
Also, you can check out this detailed guide and how to use Make with MailBluster.

We also have a video tutorial on this which shows how to import Leads from Google Sheet to MailBluster using Make:

Gmail annotations are additional details you can add to your promotional emails, such as special deals, expiration dates, and discount codes. These annotations appear in the Gmail inbox and require using a structured data format called JSON-LD.

Unfortunately, this feature is not currently available in MailBluster. We appreciate your understanding and apologize for any inconvenience.