Email marketing
Brevo in your product and your AI agents, through one API
The Brevo toolkit covers contacts, contact lists, email campaigns and transactional emails. Your customer connects their Brevo account once with an API key, and your product or AI agent calls each operation through Connect, which stores the credentials and logs every execution, instead of building and maintaining the integration.
15 days to try it. No credit card.
POST https://connect.reportei.com/api/tools/brevo_create_contact/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"email": "<email>"
}
}How it works
From a connected customer to the first Brevo call.
- 1
Your customer connects the account
Your system opens a Connect session for the toolkit and your customer connects their Brevo account. You get the connection id.
- 2
Your product calls the tool
A POST to /api/tools/{tool}/execute with the connection id and arguments. On success, Connect preserves the app's response status and body.
- 3
Connect handles the rest
It stores the credential encrypted, renews tokens for OAuth connections that support renewal and records executions in an audit trail available through the API.
Use cases
What your product does with Brevo.
Sync CRM contacts to Brevo
Create or update a contact, with updateEnabled, and add it to the right lists whenever a lead changes in your CRM.
Launch campaigns from your app
Create a draft email campaign from HTML or a template, schedule it with scheduledAt and send it from inside your product.
Agent sends order emails
An AI agent sends a transactional email with a template id and reads the messageId back to confirm delivery was accepted.
Tools
12 Brevo tools
- List contactsGETLists the contacts, newest first by default, optionally narrowed by list, date or attribute. The response has contacts and count; page with limit and offset.
- Get contactGETReturns one contact with its attributes, lists and the campaign statistics of the last 90 days.
- Create contactPOSTCreates a contact. Send email, or the SMS attribute, or ext_id. With updateEnabled set to true, an existing contact with the same identifier is updated instead of failing.
- Update contactPUTUpdates a contact. Only the fields sent change: listIds adds the contact to lists and unlinkListIds removes it from lists.
- List contact listsGETLists the contact lists with their id, name, folderId and unique subscribers. The response has lists and count; page with limit and offset.
- Create contact listPOSTCreates an empty contact list in a folder and returns its id.
- List email campaignsGETLists the email campaigns, newest first by default. The response has campaigns and count; page with limit and offset. Statistics come back only when statistics is sent.
- Get email campaignGETReturns one email campaign with its settings, recipients and report statistics.
- Create email campaignPOSTCreates an email campaign as a draft and returns its id. Send the content in exactly one of htmlContent, htmlUrl or templateId. Setting scheduledAt schedules the sending, and then recipients are required.
- Update email campaignPUTUpdates a draft or scheduled email campaign. Only the fields sent change. Setting scheduledAt schedules the sending.
API key
Your customer pastes the app's key on a Connect screen, or your system sends the key with POST /api/customer-toolkits, with no screen.
Questions about the Brevo toolkit
Do I need to build against the Brevo API?
No. Connect ships 12 Brevo tools, described and ready. Your customer connects the account and your system calls every tool through the same endpoint, with the same request format.
How does my customer connect their Brevo account?
With the mode the toolkit accepts: API key. Connect stores the credential encrypted and never returns it to your system.
Does it work with AI agents?
Yes. Each tool's input is described in JSON Schema, which your agent uses directly as a tool definition. The agent picks the tool and the arguments, and your system makes the call to Connect.
Does my customer need a Reportei account?
No. Your customer connects the account on a Connect screen, or your system sends the credential through the API, and they keep using only your product.
See Connect applied to your product.
Try it for 15 days with no card, or walk our team through your use case.
