How to Add Contacts in Brevo (Sendinblue)

Send your contacts to Brevo, formerly SendinBlue, when an entry is created or updated in your Formidable Form.

Step 1: Create your Brevo API Key

1. If you don’t have an account, create a new Brevo account.
2. Go to the Profile settings and select SMTP & API from the dropdown options.
   
3. Select the API Keys tab and click the Generate a new API Key button to generate your API Key.
   
4. Once you have generated your API key, make sure to save a copy of it right away. For security reasons, Brevo will not show you this key again.
   

Step 2: Create your Formidable form

1. If you do not already have a Formidable form to collect your leads, create a form.
2. Include an Email field, Phone field, or both.
3. If you are sending a phone number to Brevo, the number must include the country code. e.g. 91xxxxxxxxxx, +91xxxxxxxxxx, 0091xxxxxxxxxx.

Step 3: Setup your API form action

1. In your form Settings → Actions & Notifications, select the Send API data action. If you have not installed the Form Webhooks API add-on yet, you will be prompted to install it.
   
2. To add the notification URL, paste https://api.brevo.com/v3/contacts/ in the Notification URL box.
   
3. Leave the basic Auth field empty. We will be using another Formidable hook to add our API Keys to the header.
4. Set the Data Format to Raw.
5. Set the Method to Post.
6. Under Raw Data, add the formatted data below.

   {
       "updateEnabled": true,  
       "email": "[190]",  
       "emailBlacklisted": false, 
       "smsBlacklisted": false,  
   	 
       "attributes": {
           "FIRSTNAME": "[200]",  
           "LASTNAME": "[210]",   
           "SMS": "[220]"         
       },
       "listIds": [4]   
   }

   • Set updateEnabled to true if you want to enable updates for existing data.
   • Replace 190 with the ID of your email field in the form.
   • Set emailBlacklisted to true to blacklist the contact for emails. The default value is set to false.
   • Set smsBlacklisted to true to blacklist the contact for SMS. The default value is set to false.
   • Replace 200 with the ID of the first name field in your form.
   If you are using a Name field in your form, it will only retrieve the first name. You can create two single line text fields instead and assign it as your First and Last name fields.
   • Replace 210 with the ID of the last name field in your form.
   • Replace 220 with the ID of the Phone number field in your form.
   • Replace 4 with the ID of your Brevo contact list. You can use comma-separated values if you want to add multiple list, e.g. [4, 6, 8].

     If you need to find the contact list ID in Brevo, go to the Contacts → Lists page and look for the ID column.
     

7. Add your API Keys to the request header using the code snippet below. Learn more about where to put this code.

   add_filter( 'frm_api_request_args', 'my_custom_frm_api_request_header', 10, 2 );
       function my_custom_frm_api_request_header( $arg_array, $args ) {
           if ( $args['url'] == 'https://api.brevo.com/v3/contacts/' ) { // the full url where the request is being sent
                $arg_array['headers']['api-key'] = 'Your-API-Key-Here'; //Replace Your-API-Key-Here with your Brevo API key
           }
       return $arg_array;
   }

8. You are all set! Go ahead and submit an entry in your form to add a new contact to your Brevo list.