brevo

Brevo Email

Use this skill to draft, dry-run, test, and officially send transactional emails through Brevo, one recipient at a time. The skill is designed for outreach: every send is intentional, audited, and reviewable.

Boundary

• Never commit API keys. Load BREVO_API_KEY from the shell environment or a local .env.local (already in .gitignore).
• Default to dry-run. Sending requires the --send flag.
• One email per society / organisation / recipient. Do not batch unrelated recipients into a single message.
• Each official send must be approved by the user.

Inputs

The skill drives off a single request JSON file per email. See references/request-schema.md for the full shape. Minimal example:

{
  "sender":  { "email": "[email protected]", "name": "Your Name" },
  "to":      [{ "email": "[email protected]", "name": "Recipient" }],
  "subject": "Your subject here",
  "markdown": "Hi there,\n\nYour email body in Markdown.\n\nBest,\nYou"
}

Entry points

Check API access (no email sent):

skills/brevo/scripts/bootstrap_runtime.sh --check-account

Dry run (renders email, no API call):

skills/brevo/scripts/bootstrap_runtime.sh --request-file ./email_request.json

Test send (rewrites recipients to a single test address, prefixes subject):

skills/brevo/scripts/bootstrap_runtime.sh \
  --request-file ./email_request.json \
  --test-to [email protected] \
  --send

Official send (uses the recipients in the request file as-is):

skills/brevo/scripts/bootstrap_runtime.sh \
  --request-file ./email_request.json \
  --send

Setup

1. Sign in to Brevo and verify your sender address (Senders, Domains & Dedicated IPs -> Senders). Brevo will not send mail from an unverified address.
2. Create an API key at https://app.brevo.com/settings/keys/api. Pick "v3 Transactional" scope; you do not need full account access.
3. Export it in your shell, or write it to a local .env.local (which is gitignored):

   export BREVO_API_KEY=xkeysib-...
   # or:
   cp skills/brevo/.env.example .env.local
   # then edit .env.local with your key
   

4. Sanity-check the credential without sending an email:

   skills/brevo/scripts/bootstrap_runtime.sh --check-account
   

   A 200 response means the key works.