Please Note:
This article is specifically aimed at Merchants who wish to enable our integration with Brevo (formerly Sendinblue).
This set-up guide covers the steps you need to take to enable our Happy Birthday integration with Brevo.
Our integration with Brevo will push any new Birthday Club sign-up straight into Brevo and will automatically disable email sending from within the Happy Birthday app. This article will walk you through enabling the integration.
To set-up this integration, you will need a Brevo account. If you don't already have one, then you need to create a Brevo account before returning to this article to follow the set-up steps.
Step 1. Generating a Brevo API Key
Navigate to Brevo's API page by following this path: Account > SMTP & API
At the top right hand side of that page, click on the CREATE A NEW API KEY button:
Give your new API Key a name, something like Happy Birthday Integration and click on the GENERATE button:
You will then be presented with your API Key:
Please Note:
Although the message states that the API Key has automatically been copied to your clipboard, this may not be the case. Please click on the copy icon to the right of the API Key to copy it to your clipboard.
Now navigate to the Happy Birthday app within your Shopify store.
Step 2. Enabling the Integration within the Happy Birthday App
Click on the Integrations link from the main navigation within the Happy Birthday app and you will see the Brevo(Sendinblue) integration section:
Click on the View Details button and once the screen has refreshed, click on the button labelled Enable Brevo Integration:
Add your Brevo API Key
The page will then present you with a section where you can paste in your Brevo API Key.
Paste in the API key from your clipboard:
If, for some reason, you enter an incorrect API Key into this setting, you will be presented with the following message. Please check that you have entered your Brevo API Key correctly.
If this still fails, you may need to repeat the process of generating your Brevo API Key.
As soon as you have entered a valid Brevo API Key, a further dropdown will be displayed asking which Brevo list you would like to associate with the Happy Birthday integration.
Choose your Brevo list
The list you choose will be where Happy Birthday sends new contacts to and where it will look for updates to Brevo contacts within that list:
Choose your list. In this example, the list we have selected is called Happy Birthday Campaign, however, your list is likely to be named differently.
Choose or create your birthdate contact attribute
Once you have chosen your list, a further dropdown will be presented for you to select the contact attribute where the contact's birthdate will be stored:
If you do not already have a Birthdate contact attribute, select the option to create a new one. We will then create that contact attribute within your chosen list:
If you already have a Birthdate contact attribute, select it from the dropdown:
The setting I will be using Brevo to deliver my birthday emails will be enabled by default which will turn off the birthday email sending function within the Happy Birthday app. If you decide for some reason that want to use our default birthday email sending, but you'd still like us to send the contacts through to your Brevo account, then you will need to make sure this setting is unchecked:
Click on Save Settings and you will see a pop-up notification that the integration is live.
What happens now?
We will create a contact attribute in Brevo called BDAYLINK. If you have asked us to create a birthdate field, then we will create that too. The attributes are shown below, however, they are likely to be empty in the first instance:
When you receive your next Birthday Club sign-up, that contact will be pushed through to your Brevo account along with their Birthday and unique Birthday Discount Link.
If the contact already exists in your Brevo account, then we will only append their Birthdate and the Birthday Discount Link contact attribute to their profile.
If you add a Birthdate to an existing contact in Brevo, that contact will be sent to the Happy Birthday app and we will send back their Birthday Discount Link.
What next?
You will now need to set-up your Birthday email campaign and email template in Brevo.
FAQs
Will enabling the integration automatically push existing Happy Birthday sign-ups into Brevo?
Will enabling the integration automatically import existing Brevo contacts into Happy Birthday?
Need any help?
If you need any help setting up your Brevo integration then please do just get in touch!