How to connect Convert Forms with SendinBlue

Published in Convert Forms
Updated 24 Jun, 2021

API v2 deprecation: From June 25 2021 onwards, SendinBlue will drop support for API v2 and you will need to use the API v3 key. Click here to update your API key.

Convert Forms offers seamless integration with the SendinBlue email marketing service. Connecting Convert Forms to your SendinBlue email lists is surprisingly easy. Follow our step by step guide on how to connect Convert Forms with SendinBlue below.


1. Addon Installation

  • Navigate to Components > Convert Forms > Addons
  • Click the Cog button for the SendinBlue Addon. A popup will appear where you can enable the addon.

sendinblue convert forms addon

  • Click on the Status and select Enabled.
  • Now you can click on Save & Close button to save the enabled addon.

convert forms update plugin status

2. Campaign Setup

To setup a Campaign with SendinBlue, follow the steps below.

sendinblue campaign convert forms

  • Navigate to Components > Convert Forms > Campaigns
  • Create a new Campaign by clicking New
  • Type a name for your Campaign. This name can not be seen by anyone else but you.
  • For the Sync Leads > Choose Service selectbox choose SendinBlue. If you can not find the SendinBlue option then you do not have the SendinBlue Addon installed and activated. In that case, please go back to the top of the article and see how to install the mandatory addon.
  • Save the Campaign for the special SendinBlue fields to show up.

SendinBlue API Version

From June 25 2021 and onwards, SendinBlue will only support the API version 3 instead of version 2. This requires you to use the v3 API key which you can do so by reading below.

SendinBlue API Key

To obtain your SendinBlue API Key you need to log into your SendinBlue Account and click on the top right on your Account Name > SMTP & API.

Once you are in the API Key Screen, copy your v3 API Key and paste it back into the Campaign settings you were setting up previously in Convert Forms. See the screenshot below to identify your API Key.

sendinblue api key

SendinBlue List ID

To obtain your SendinBlue List ID you need to navigate to Contacts located on the top side of the screen and then click on Lists from the left navigation bar.

sendinblue list menu item

Once you are there, you will be able to see your List IDs next to their names as they are shown in the screenshot above. Now you can type the list ID into the Campaign settings exactly as you did previously with the API Key. If you want multiple list IDs you can use a comma separated list like 1,2,3

sendinblue list ids

Finally, now that you have both prerequisite fields, you can Save & Close this Convert Forms Campaign.

3. Email & Name Fields

Email

For a Convert Form to successfully store an email address to your SendinBlue account it needs to have an email field. This field is already set up at the time of creating the form and you don't have to change its input value as it is already configured for you.

convert forms email field

First Name

If you want to store the contact's first name you should create a field named firstname. See the screenshot below to understand where to set it up.

convert forms first name field

Last Name

If you want to store the contact's last name you should create a field named lastname. See the screenshot below to understand where to set it up.

convert forms last name field

4. SendinBlue Custom Fields

SendinBlue offers custom fields to collect more types of data for each of your contacts. We can also use these custom fields in a Convert Form for a more efficient data gathering and by extension, a more efficient campaign. Let's see how.

First you need to navigate to your SendinBlue Account, click "Contacts" > "Settings" in the sidebar and finally click the "Configure" button in the "Contact Attributes & CRM" panel.

sendinblue custom field

Once you are there you are able to create and manage your own custom fields. As an example in the screenshot above we have created an Age custom field and a Country custom field.

With the custom fields you have configured on your SendinBlue Account, you can now proceed and use the same ones in your Convert Form. For example, we used our Age and Country custom fields in our Convert Form in the screenshot below.

sendinblue convert forms custom field age

sendinblue convert forms custom field country

5. Override List ID

The SendinBlue integration is flexible enough to let us override the List ID we setup in the campaign setting. You can use this flexibility for each of your forms with just a hidden field.

sendinblue convert forms override listid

As you can see in the screenshot above, we created a new hidden field and named it "listid". Then for a value we added our comma separated list of listids. For our example we wanted to use specifically the lists with IDs 1,4.

6. Assign form to Campaign

Of course don't forget to assign the form to our newly created Campaign! See the screenshot below to understand where to assign it.

sendinblue convert forms assignment