Wiro Docs Brevo Integration
This section as Markdown: View Download

Brevo Integration

Connect your agent to Brevo (formerly Sendinblue) for transactional and marketing email.

Overview

The Brevo integration uses Brevo API v3 with an api-key header (not Bearer).

Skills that use this integration:

  • brevo-email — Campaign, template, and contact management via Brevo API v3
  • newsletter-compose — uses Brevo as the ESP when enabled alongside

Other: Custom agents can call the Brevo API via whatever skill invokes BREVO_API_KEY.

Agents that typically enable this integration:

  • Newsletter Manager

Availability

Mode Status Notes
API Key (v3) Available Standard Brevo API v3 keys.

Prerequisites

Setup

Step 1: Get an API key

  1. app.brevo.com → profile (top right) → SMTP & API → API Keys.
  2. Generate a new API key, name "Wiro agent".
  3. Copy the key (starts with xkeysib-).

Step 2: Save to Wiro

curl -X POST "https://api.wiro.ai/v1/UserAgent/CredentialUpsert" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "useragentguid": "your-useragent-guid",
    "fields": [
      { "credentialkey": "brevo", "fieldname": "apikey", "fieldvalue": "xkeysib-xxxxxxxxxxxxxxxxxxxx" }
    ]
  }'

Step 3: Start the agent

curl -X POST "https://api.wiro.ai/v1/UserAgent/Start" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{ "guid": "your-useragent-guid" }'

Credential Fields

Field Type Description
apikey string Brevo v3 API key (starts with xkeysib-).

Credentials schema (as returned by POST /UserAgent/Detail)

"brevo": {
  "_connected": false,
  "optional": true,
  "extra": false,
  "apikey": ""
}

Runtime Behavior

Env vars (exported only when brevo-email skill is enabled and apikey is set):

  • BREVO_API_KEY ← credentials.brevo.apikey

Auth: Header api-key: $BREVO_API_KEY — not Bearer. This is Brevo's documented auth pattern.
Base URL: https://api.brevo.com/v3/.

Rate limits: ~10 req/s on free plan; higher on paid tiers.

Troubleshooting

  • 401 Unauthorized: Key revoked or deleted. Generate a new one.
  • Emails go to spam: Verify sending domain under Brevo → Senders & IP → Domains. Set up SPF, DKIM, DMARC.
  • Rate limit (429): Free tier is 300 emails/day. Upgrade plan.