Brevo Connector
Prerequisites
- A Brevo account (formerly Sendinblue), any plan
- Admin access to generate API keys
Getting Your Credentials
Brevo uses an API Key for authentication.
- Log into Brevo
- Go to Settings (gear icon) > API Keys
- Click Generate a new API key
- Name it (e.g.,
Landed sync) - Copy the key (starts with
xkeysib-)
Important: Brevo only shows the full API key once at creation. Save it securely.
Configuration in Landed
| Field | Value |
|---|---|
| API Key | Your Brevo API key (starts with xkeysib-) |
| Start Date (optional) | ISO 8601 date for initial backfill of date-windowed streams (e.g., 2024-01-01) |
The Start Date controls how far back Landed fetches data for email_events and transactional_emails. If not set, Landed uses a sensible default.
Available Streams
| Stream | Description | Sync Mode |
|---|---|---|
contacts | Contact records with email, attributes, list membership | Incremental |
email_campaigns | Email campaigns with subject, sender, stats (opens, clicks, bounces) | Incremental |
email_events | Individual email events (delivered, opened, clicked, bounced) | Incremental |
transactional_emails | Transactional email history | Incremental |
contact_lists | Contact list definitions with subscriber counts | Full refresh |
email_templates | Email template records | Full refresh |
Common Issues
| Symptom | Cause | Fix |
|---|---|---|
401 Unauthorized | Invalid API key | Generate a new key in Brevo > Settings > API Keys |
Key format invalid | Key doesn't start with xkeysib- | Ensure you copied the full API key including the prefix |
| Slow sync for email_events | Large date range | Set a more recent Start Date to limit the backfill window |
Rate limit exceeded | Too many API calls | Landed handles rate limiting automatically; Brevo has strict rate limits (~100 req/hour on some endpoints) |
Data Notes
- Brevo's API has aggressive rate limits (100 requests/hour on some endpoints). Landed automatically throttles requests to stay within limits, which may result in longer sync times.
- Email events and transactional emails are fetched in date windows (90 days and 30 days respectively) to work within API constraints.
Static IPs for Allowlisting
If your network configuration requires IP allowlisting:
- Production:
34.170.185.84,35.192.90.94 - Staging:
34.171.93.34