# Brevo

Manage Brevo (Sendinblue) email/SMS: contacts, campaigns, transactional. Exposes **52 actions** covering the full API surface
the agent needs - read and write.

## What it can do

| Method | What it does |
| --- | --- |
| `brevo_get_account` | Get account information (name, email, plan, usage, credits). |
| `brevo_create_contact` | Create a contact or update if exists - POST /contacts. |
| `brevo_get_contact` | Get contact details by email or ID - GET /contacts/{emailOrId}. |
| `brevo_update_contact` | Update a contact - PUT /contacts/{emailOrId}. |
| `brevo_list_contacts` | List all contacts - GET /contacts. |
| `brevo_delete_contact` | Delete a contact by email or ID - DELETE /contacts/{emailOrId}. |
| `brevo_batch_delete_contacts` | Batch delete contacts - POST /contacts/delete. |
| `brevo_import_contacts` | Import contacts from CSV file - POST /contacts/import. |
| `brevo_export_contacts` | Export contacts to file - POST /contacts/export. |
| `brevo_create_list` | Create a contact list - POST /contacts/lists. |
| `brevo_get_list` | Get list details - GET /contacts/lists/{listId}. |
| `brevo_update_list` | Update list - PUT /contacts/lists/{listId}. |
| `brevo_delete_list` | Delete a list - DELETE /contacts/lists/{listId}. |
| `brevo_list_lists` | List all lists - GET /contacts/lists. |
| `brevo_get_list_contacts` | Get contacts in a list - GET /contacts/lists/{listId}/contacts. |
| `brevo_add_contacts_to_list` | Add contacts to a list - POST /contacts/lists/{listId}/contacts/add. |
| `brevo_remove_contacts_from_list` | Remove contacts from a list - POST /contacts/lists/{listId}/contacts/remove. |
| `brevo_create_email_campaign` | Create an email campaign - POST /emailCampaigns. |
| `brevo_get_email_campaign` | Get campaign details - GET /emailCampaigns/{campaignId}. |
| `brevo_update_email_campaign` | Update a campaign draft - PUT /emailCampaigns/{campaignId}. |
| `brevo_delete_email_campaign` | Delete a campaign - DELETE /emailCampaigns/{campaignId}. |
| `brevo_send_email_campaign` | Send/schedule a campaign - POST /emailCampaigns/{campaignId}/send. |
| `brevo_clone_email_campaign` | Clone a campaign - POST /emailCampaigns/{campaignId}/clone. |
| `brevo_archive_email_campaign` | Archive a campaign - POST /emailCampaigns/{campaignId}/archive. |
| `brevo_list_email_campaigns` | List email campaigns - GET /emailCampaigns. |
| `brevo_get_email_campaign_stats` | Get email campaign stats (opens, clicks, bounces, complaints) - GET /emailCampaigns/{campaignId}/stats. |
| `brevo_create_email_template` | Create an email template - POST /emailTemplates. |
| `brevo_get_email_template` | Get template details - GET /emailTemplates/{templateId}. |
| `brevo_update_email_template` | Update a template - PUT /emailTemplates/{templateId}. |
| `brevo_delete_email_template` | Delete a template - DELETE /emailTemplates/{templateId}. |
| `brevo_list_email_templates` | List email templates - GET /emailTemplates. |
| `brevo_export_email_template` | Export template HTML - GET /emailTemplates/{templateId}/export. |
| `brevo_send_smtp_email` | Send a transactional email - POST /smtp/email. |
| `brevo_list_senders` | List senders (verified from addresses) - GET /senders. |
| `brevo_add_sender` | Add a sender - POST /senders. |
| `brevo_verify_sender` | Verify a sender email - POST /senders/{senderId}/verify. |
| `brevo_delete_sender` | Delete a sender - DELETE /senders/{senderId}. |
| `brevo_update_sender` | Update a sender - PUT /senders/{senderId}. |
| `brevo_create_sms_campaign` | Create an SMS campaign - POST /smsCampaigns. |
| `brevo_get_sms_campaign` | Get SMS campaign details - GET /smsCampaigns/{campaignId}. |
| `brevo_update_sms_campaign` | Update an SMS campaign draft - PUT /smsCampaigns/{campaignId}. |
| `brevo_delete_sms_campaign` | Delete an SMS campaign - DELETE /smsCampaigns/{campaignId}. |
| `brevo_send_sms_campaign` | Send/schedule an SMS campaign - POST /smsCampaigns/{campaignId}/send. |
| `brevo_list_sms_campaigns` | List SMS campaigns - GET /smsCampaigns. |
| `brevo_create_webhook` | Create a webhook - POST /webhooks. |
| `brevo_get_webhook` | Get webhook details - GET /webhooks/{webhookId}. |
| `brevo_update_webhook` | Update a webhook - PUT /webhooks/{webhookId}. |
| `brevo_delete_webhook` | Delete a webhook - DELETE /webhooks/{webhookId}. |
| `brevo_list_webhooks` | List webhooks - GET /webhooks. |
| `brevo_list_attributes` | List contact attributes (custom fields schema) - GET /contacts/attributes. |
| `brevo_list_segments` | List dynamic segments - GET /contacts/segments. |
| `brevo_get_segment` | Get segment details - GET /contacts/segments/{segmentId}. |

## How to get credentials

This connector uses an **API key / token**. Create one in the provider
dashboard, then paste it into FlyMyAI:

- **`BREVO_API_KEY`** - Brevo - SMTP & API - API Keys - Generate a new API key. (https://app.brevo.com/settings/keys/api)

## Fields to fill in FlyMyAI

| FlyMyAI field | Where it comes from |
| --- | --- |
| `BREVO_API_KEY` | Brevo - SMTP & API - API Keys - Generate a new API key. |

## Troubleshooting

- **`401 Unauthorized` / `403 Forbidden`** - the token is wrong, expired, or missing a required scope - regenerate it.
- **`429 Too Many Requests`** - you hit the provider rate limit; retry after a short backoff.
- **Unexpected `4xx` on writes** - double-check required fields; the agent confirms before write actions.

## Links

- [Brevo API documentation](https://developers.brevo.com/reference)