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.
- Addon Installation
- Campaign Setup
- Email & Name Fields
- SendinBlue Custom Fields
- Override List ID
- Assign form to Campaign
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.
- Click on the Status and select Enabled.
- Now you can click on Save & Close button to save the enabled addon.
2. Campaign Setup
To setup a Campaign with SendinBlue, follow the steps below.
- 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 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.
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
Finally, now that you have both prerequisite fields, you can Save & Close this Convert Forms Campaign.
3. Email & Name Fields
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.
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.
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.
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.
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.
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.
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.