Brevo

Pro plan. Brevo works through a connection and HTTP steps, which are part of Pro and Agency (and the free trial). Anything you already have keeps working on every plan. See Plans and billing.

When a contact accepts your invitation and has an email, a Webhook / HTTP step creates them in Brevo (or updates them if they exist) and adds them to the list your newsletter or Brevo automation uses.

How it connects: Brevo’s API v3 with your key in the api-key header. See Brevo’s Create a contact docs. The request and answers below follow Brevo’s docs.

Before you start

Brevo plan: the API is available on Brevo’s free plan; sending limits depend on your plan.
An API key: in Brevo, open SMTP & API > API keys and create one.
The list’s id: in Contacts > Lists.
Attributes: the attributes you send (for example FNAME, LNAME) must already exist in Contacts > Settings.
Consent: add people to a newsletter only on a basis your law allows; a double opt-in list is the safe choice.

1. Connect Brevo

In Kerux, open Integrations > Connections, click Connect on Custom API (under Developers):

How it signs in: API key in a header, Header name api-key, paste the key.
Base URL: https://api.brevo.com

Click Save, then Test connection.

2. Create or update the contact

After Invitation accepted and a Condition that the contact has an email, add a Webhook / HTTP step named brevo:

{
  "method": "POST",
  "url": "/v3/contacts",
  "bodyType": "json",
  "body": {
    "email": "{{email}}",
    "attributes": { "FNAME": "{{contact.first_name}}", "LNAME": "{{contact.last_name | optional}}" },
    "listIds": [12],
    "updateEnabled": true
  }
}

Replace 12 with your list’s id. A new contact comes back as 201 with its id:

{ "id": 21 }

An existing contact is updated and Brevo answers 204 with no body. Both count as success in Kerux.

Test with one contact

In the Builder, click Test to open Test on one contact with your own email. Check the contact and the list in Brevo.

Common errors

400 with an attribute error

An attribute you send doesn’t exist in Brevo. Create it in Contacts > Settings, or remove it from the body.

400 duplicate_parameter

The contact exists and updateEnabled isn’t true. Add it to the body.

401 Unauthorized

The key is wrong. Create a new one in SMTP & API > API keys and edit the connection.

Getting started

Campaigns

Account safety

Inbox

Contacts

Integrations

Integration guides

Developers

Account & billing

Help

Before you start

1. Connect Brevo

2. Create or update the contact

Test with one contact

Common errors

​Before you start

​1. Connect Brevo

​2. Create or update the contact

​Test with one contact

​Common errors

Before you start

1. Connect Brevo

2. Create or update the contact

Test with one contact

Common errors