Hello {{params.name}}
\",\n \"params\": {\"name\": \"John\"}\n }'" }, { "title": "Send with Template", "body": "curl -X POST \"https://api.brevo.com/v3/smtp/email\" \\\n -H \"api-key: $BREVO_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"to\": [{\"email\": \"user@example.com\"}],\n \"templateId\": 34,\n \"params\": {\n \"NOMBRE\": \"John\",\n \"FECHA\": \"2026-02-01\"\n }\n }'" }, { "title": "List All Contact Lists", "body": "curl \"https://api.brevo.com/v3/contacts/lists?limit=50\" \\\n -H \"api-key: $BREVO_KEY\"" }, { "title": "Add Contacts to List (Bulk)", "body": "curl -X POST \"https://api.brevo.com/v3/contacts/lists/10/contacts/add\" \\\n -H \"api-key: $BREVO_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"emails\": [\"user1@example.com\", \"user2@example.com\"]\n }'" }, { "title": "Safe Import Pattern", "body": "When importing contacts, always respect unsubscribes:\n\nimport requests\n\nBREVO_KEY = \"your-api-key\"\nHEADERS = {'api-key': BREVO_KEY, 'Content-Type': 'application/json'}\nBASE = 'https://api.brevo.com/v3'\n\ndef get_blacklisted():\n \"\"\"Get all unsubscribed/blacklisted emails\"\"\"\n blacklisted = set()\n offset = 0\n while True:\n r = requests.get(\n f'{BASE}/contacts?limit=100&offset={offset}&emailBlacklisted=true',\n headers=HEADERS\n )\n contacts = r.json().get('contacts', [])\n if not contacts:\n break\n for c in contacts:\n blacklisted.add(c['email'].lower())\n offset += 100\n return blacklisted\n\ndef safe_import(emails, list_id):\n \"\"\"Import contacts respecting unsubscribes\"\"\"\n blacklisted = get_blacklisted()\n \n for email in emails:\n if email.lower() in blacklisted:\n print(f\"Skipped (unsubscribed): {email}\")\n continue\n \n r = requests.post(f'{BASE}/contacts', headers=HEADERS, json={\n 'email': email,\n 'listIds': [list_id],\n 'updateEnabled': True\n })\n \n if r.status_code in [200, 201, 204]:\n print(f\"Imported: {email}\")\n else:\n print(f\"Error: {email} - {r.text[:50]}\")" }, { "title": "Contact Attributes", "body": "Brevo uses custom attributes for contact data:\n\n{\n \"attributes\": {\n \"NOMBRE\": \"John\",\n \"APELLIDOS\": \"Doe\",\n \"FECHA_ALTA\": \"2026-01-15\",\n \"PLAN\": \"premium\",\n \"CUSTOM_FIELD\": \"any value\"\n }\n}\n\nCreate attributes in Brevo dashboard: Contacts → Settings → Contact attributes." }, { "title": "Response Codes", "body": "CodeMeaning200Success (GET)201Created (POST)204Success, no content (PUT/DELETE)400Bad request (check payload)401Invalid API key404Contact/resource not found" }, { "title": "Best Practices", "body": "Always check blacklist before importing contacts\nUse updateEnabled: true to update existing contacts instead of failing\nUse templates for consistent transactional emails\nBatch operations when adding many contacts to lists\nStore list IDs in config, not hardcoded\nLog imports for audit trail" }, { "title": "Automations", "body": "Brevo automations trigger on:\n\nContact added to list\nContact attribute updated\nEmail opened/clicked\nCustom events via API\n\nTrigger automation manually:\n\ncurl -X POST \"https://api.brevo.com/v3/contacts/import\" \\\n -H \"api-key: $BREVO_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"listIds\": [10],\n \"emailBlacklist\": false,\n \"updateExistingContacts\": true,\n \"emptyContactsAttributes\": false,\n \"jsonBody\": [\n {\"email\": \"user@example.com\", \"attributes\": {\"NOMBRE\": \"John\"}}\n ]\n }'" }, { "title": "Useful Queries", "body": "# Count contacts in list\ncurl \"https://api.brevo.com/v3/contacts/lists/10\" -H \"api-key: $BREVO_KEY\" | jq '.totalSubscribers'\n\n# Get recent contacts\ncurl \"https://api.brevo.com/v3/contacts?limit=10&sort=desc\" -H \"api-key: $BREVO_KEY\"\n\n# Check if email exists\ncurl \"https://api.brevo.com/v3/contacts/user@example.com\" -H \"api-key: $BREVO_KEY\"\n\n# Get account info\ncurl \"https://api.brevo.com/v3/account\" -H \"api-key: $BREVO_KEY\"" } ], "body": "Brevo Email Marketing API\n\nManage contacts, send emails, and automate marketing via Brevo's REST API.\n\nAuthentication\nBREVO_KEY=$(cat ~/.config/brevo/api_key)\n\n\nAll requests require header: api-key: $BREVO_KEY\n\nBase URL\nhttps://api.brevo.com/v3\n\nCommon Endpoints\nContacts\nAction\tMethod\tEndpoint\nCreate contact\tPOST\t/contacts\nGet contact\tGET\t/contacts/{email}\nUpdate contact\tPUT\t/contacts/{email}\nDelete contact\tDELETE\t/contacts/{email}\nList contacts\tGET\t/contacts?limit=50&offset=0\nGet blacklisted\tGET\t/contacts?emailBlacklisted=true\nLists\nAction\tMethod\tEndpoint\nGet all lists\tGET\t/contacts/lists\nCreate list\tPOST\t/contacts/lists\nGet list contacts\tGET\t/contacts/lists/{listId}/contacts\nAdd to list\tPOST\t/contacts/lists/{listId}/contacts/add\nRemove from list\tPOST\t/contacts/lists/{listId}/contacts/remove\nEmails\nAction\tMethod\tEndpoint\nSend transactional\tPOST\t/smtp/email\nSend campaign\tPOST\t/emailCampaigns\nGet templates\tGET\t/smtp/templates\nExamples\nCreate/Update Contact\ncurl -X POST \"https://api.brevo.com/v3/contacts\" \\\n -H \"api-key: $BREVO_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"email\": \"user@example.com\",\n \"listIds\": [10],\n \"updateEnabled\": true,\n \"attributes\": {\n \"NOMBRE\": \"John\",\n \"APELLIDOS\": \"Doe\"\n }\n }'\n\nGet Contact Info\ncurl \"https://api.brevo.com/v3/contacts/user@example.com\" \\\n -H \"api-key: $BREVO_KEY\"\n\nUpdate Contact Attributes\ncurl -X PUT \"https://api.brevo.com/v3/contacts/user@example.com\" \\\n -H \"api-key: $BREVO_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"listIds\": [10, 15],\n \"attributes\": {\n \"CUSTOM_FIELD\": \"value\"\n }\n }'\n\nSend Transactional Email\ncurl -X POST \"https://api.brevo.com/v3/smtp/email\" \\\n -H \"api-key: $BREVO_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"sender\": {\"name\": \"My App\", \"email\": \"noreply@example.com\"},\n \"to\": [{\"email\": \"user@example.com\", \"name\": \"John\"}],\n \"subject\": \"Welcome!\",\n \"htmlContent\": \"Hello {{params.name}}
\",\n \"params\": {\"name\": \"John\"}\n }'\n\nSend with Template\ncurl -X POST \"https://api.brevo.com/v3/smtp/email\" \\\n -H \"api-key: $BREVO_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"to\": [{\"email\": \"user@example.com\"}],\n \"templateId\": 34,\n \"params\": {\n \"NOMBRE\": \"John\",\n \"FECHA\": \"2026-02-01\"\n }\n }'\n\nList All Contact Lists\ncurl \"https://api.brevo.com/v3/contacts/lists?limit=50\" \\\n -H \"api-key: $BREVO_KEY\"\n\nAdd Contacts to List (Bulk)\ncurl -X POST \"https://api.brevo.com/v3/contacts/lists/10/contacts/add\" \\\n -H \"api-key: $BREVO_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"emails\": [\"user1@example.com\", \"user2@example.com\"]\n }'\n\nSafe Import Pattern\n\nWhen importing contacts, always respect unsubscribes:\n\nimport requests\n\nBREVO_KEY = \"your-api-key\"\nHEADERS = {'api-key': BREVO_KEY, 'Content-Type': 'application/json'}\nBASE = 'https://api.brevo.com/v3'\n\ndef get_blacklisted():\n \"\"\"Get all unsubscribed/blacklisted emails\"\"\"\n blacklisted = set()\n offset = 0\n while True:\n r = requests.get(\n f'{BASE}/contacts?limit=100&offset={offset}&emailBlacklisted=true',\n headers=HEADERS\n )\n contacts = r.json().get('contacts', [])\n if not contacts:\n break\n for c in contacts:\n blacklisted.add(c['email'].lower())\n offset += 100\n return blacklisted\n\ndef safe_import(emails, list_id):\n \"\"\"Import contacts respecting unsubscribes\"\"\"\n blacklisted = get_blacklisted()\n \n for email in emails:\n if email.lower() in blacklisted:\n print(f\"Skipped (unsubscribed): {email}\")\n continue\n \n r = requests.post(f'{BASE}/contacts', headers=HEADERS, json={\n 'email': email,\n 'listIds': [list_id],\n 'updateEnabled': True\n })\n \n if r.status_code in [200, 201, 204]:\n print(f\"Imported: {email}\")\n else:\n print(f\"Error: {email} - {r.text[:50]}\")\n\nContact Attributes\n\nBrevo uses custom attributes for contact data:\n\n{\n \"attributes\": {\n \"NOMBRE\": \"John\",\n \"APELLIDOS\": \"Doe\",\n \"FECHA_ALTA\": \"2026-01-15\",\n \"PLAN\": \"premium\",\n \"CUSTOM_FIELD\": \"any value\"\n }\n}\n\n\nCreate attributes in Brevo dashboard: Contacts → Settings → Contact attributes.\n\nResponse Codes\nCode\tMeaning\n200\tSuccess (GET)\n201\tCreated (POST)\n204\tSuccess, no content (PUT/DELETE)\n400\tBad request (check payload)\n401\tInvalid API key\n404\tContact/resource not found\nBest Practices\nAlways check blacklist before importing contacts\nUse updateEnabled: true to update existing contacts instead of failing\nUse templates for consistent transactional emails\nBatch operations when adding many contacts to lists\nStore list IDs in config, not hardcoded\nLog imports for audit trail\nAutomations\n\nBrevo automations trigger on:\n\nContact added to list\nContact attribute updated\nEmail opened/clicked\nCustom events via API\n\nTrigger automation manually:\n\ncurl -X POST \"https://api.brevo.com/v3/contacts/import\" \\\n -H \"api-key: $BREVO_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"listIds\": [10],\n \"emailBlacklist\": false,\n \"updateExistingContacts\": true,\n \"emptyContactsAttributes\": false,\n \"jsonBody\": [\n {\"email\": \"user@example.com\", \"attributes\": {\"NOMBRE\": \"John\"}}\n ]\n }'\n\nUseful Queries\n# Count contacts in list\ncurl \"https://api.brevo.com/v3/contacts/lists/10\" -H \"api-key: $BREVO_KEY\" | jq '.totalSubscribers'\n\n# Get recent contacts\ncurl \"https://api.brevo.com/v3/contacts?limit=10&sort=desc\" -H \"api-key: $BREVO_KEY\"\n\n# Check if email exists\ncurl \"https://api.brevo.com/v3/contacts/user@example.com\" -H \"api-key: $BREVO_KEY\"\n\n# Get account info\ncurl \"https://api.brevo.com/v3/account\" -H \"api-key: $BREVO_KEY\"" }, "trust": { "sourceLabel": "tencent", "provenanceUrl": "https://clawhub.ai/yujesyoga/brevo", "publisherUrl": "https://clawhub.ai/yujesyoga/brevo", "owner": "yujesyoga", "version": "1.0.0", "license": null, "verificationStatus": "Indexed source record" }, "links": { "detailUrl": "https://openagent3.xyz/skills/brevo", "downloadUrl": "https://openagent3.xyz/downloads/brevo", "agentUrl": "https://openagent3.xyz/skills/brevo/agent", "manifestUrl": "https://openagent3.xyz/skills/brevo/agent.json", "briefUrl": "https://openagent3.xyz/skills/brevo/agent.md" } }