Open Skills Logo
Open Skills

brevo-automation

通过Rube MCP（Composio）自动化Brevo（Sendinblue）任务：管理邮件营销活动、创建/编辑模板、追踪发件人状态，并监控活动表现。请始终优先搜索工具以获取最新架构信息。

查看详情
name:brevo-automationdescription:"Automate Brevo (Sendinblue) tasks via Rube MCP (Composio): manage email campaigns, create/edit templates, track senders, and monitor campaign performance. Always search tools first for current schemas."requires:mcp:[rube]

Brevo Automation via Rube MCP

Automate Brevo (formerly Sendinblue) email marketing operations through Composio's Brevo toolkit via Rube MCP.

Prerequisites

  • Rube MCP must be connected (RUBE_SEARCH_TOOLS available)

  • Active Brevo connection via RUBE_MANAGE_CONNECTIONS with toolkit brevo

  • Always call RUBE_SEARCH_TOOLS first to get current tool schemas

    • Setup

    Get Rube MCP: Add https://rube.app/mcp as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.


  • Verify Rube MCP is available by confirming RUBE_SEARCH_TOOLS responds

  • Call RUBE_MANAGE_CONNECTIONS with toolkit brevo

  • If connection is not ACTIVE, follow the returned auth link to complete Brevo authentication

  • Confirm connection status shows ACTIVE before running any workflows

    • Core Workflows

    1. Manage Email Campaigns

    When to use: User wants to list, review, or update email campaigns

    Tool sequence:

  • BREVO_LIST_EMAIL_CAMPAIGNS - List all campaigns with filters [Required]

  • BREVO_UPDATE_EMAIL_CAMPAIGN - Update campaign content or settings [Optional]

    • Key parameters for listing:

  • type: Campaign type ('classic' or 'trigger')

  • status: Campaign status ('suspended', 'archive', 'sent', 'queued', 'draft', 'inProcess', 'inReview')

  • startDate/endDate: Date range filter (YYYY-MM-DDTHH:mm:ss.SSSZ format)

  • statistics: Stats type to include ('globalStats', 'linksStats', 'statsByDomain')

  • limit: Results per page (max 100, default 50)

  • offset: Pagination offset

  • sort: Sort order ('asc' or 'desc')

  • excludeHtmlContent: Set true to reduce response size

    • Key parameters for update:

  • campaign_id: Numeric campaign ID (required)

  • name: Campaign name

  • subject: Email subject line

  • htmlContent: HTML email body (mutually exclusive with htmlUrl)

  • htmlUrl: URL to HTML content

  • sender: Sender object with name, email, or id

  • recipients: Object with listIds and exclusionListIds

  • scheduledAt: Scheduled send time (YYYY-MM-DDTHH:mm:ss.SSSZ)

    • Pitfalls:

  • startDate and endDate are mutually required; provide both or neither

  • Date filters only work when status is not passed or set to 'sent'

  • htmlContent and htmlUrl are mutually exclusive

  • Campaign sender email must be a verified sender in Brevo

  • A/B testing fields (subjectA, subjectB, splitRule, winnerCriteria) require abTesting: true

  • scheduledAt uses full ISO 8601 format with timezone

    • 2. Create and Manage Email Templates

    When to use: User wants to create, edit, list, or delete email templates

    Tool sequence:

  • BREVO_GET_ALL_EMAIL_TEMPLATES - List all templates [Required]

  • BREVO_CREATE_OR_UPDATE_EMAIL_TEMPLATE - Create a new template or update existing [Required]

  • BREVO_DELETE_EMAIL_TEMPLATE - Delete an inactive template [Optional]

    • Key parameters for listing:

  • templateStatus: Filter active (true) or inactive (false) templates

  • limit: Results per page (max 1000, default 50)

  • offset: Pagination offset

  • sort: Sort order ('asc' or 'desc')

    • Key parameters for create/update:

  • templateId: Include to update; omit to create new

  • templateName: Template display name (required for creation)

  • subject: Email subject line (required for creation)

  • htmlContent: HTML template body (min 10 characters; use this or htmlUrl)

  • sender: Sender object with name and email, or id (required for creation)

  • replyTo: Reply-to email address

  • isActive: Activate or deactivate the template

  • tag: Category tag for the template

    • Pitfalls:

  • When templateId is provided, the tool updates; when omitted, it creates

  • For creation, templateName, subject, and sender are required

  • htmlContent must be at least 10 characters

  • Template personalization uses {{contact.ATTRIBUTE}} syntax

  • Only inactive templates can be deleted

  • htmlContent and htmlUrl are mutually exclusive

    • 3. Manage Senders

    When to use: User wants to view authorized sender identities

    Tool sequence:

  • BREVO_GET_ALL_SENDERS - List all verified senders [Required]

    • Key parameters: (none required)

    Pitfalls:

  • Senders must be verified before they can be used in campaigns or templates

  • Sender verification is done through the Brevo web interface, not via API

  • Sender IDs can be used in sender.id fields for campaigns and templates

    • 4. Configure A/B Testing Campaigns

    When to use: User wants to set up or modify A/B test settings on a campaign

    Tool sequence:

  • BREVO_LIST_EMAIL_CAMPAIGNS - Find the target campaign [Prerequisite]

  • BREVO_UPDATE_EMAIL_CAMPAIGN - Configure A/B test settings [Required]

    • Key parameters:

  • campaign_id: Campaign to configure

  • abTesting: Set to true to enable A/B testing

  • subjectA: Subject line for variant A

  • subjectB: Subject line for variant B

  • splitRule: Percentage split for the test (1-99)

  • winnerCriteria: 'open' or 'click' for determining the winner

  • winnerDelay: Hours to wait before selecting winner (1-168)

    • Pitfalls:

  • A/B testing must be enabled (abTesting: true) before setting variant fields

  • splitRule is the percentage of contacts that receive variant A

  • winnerDelay defines how long to test before sending the winner to remaining contacts

  • Only works with 'classic' campaign type

    • Common Patterns

    Campaign Lifecycle

    1. Create campaign (status: draft)
  • Set recipients (listIds)

  • Configure content (htmlContent or htmlUrl)

  • Optionally schedule (scheduledAt)

  • Send or schedule via Brevo UI (API update can set scheduledAt)

    • Pagination

  • Use limit (page size) and offset (starting index)

  • Default limit is 50; max varies by endpoint (100 for campaigns, 1000 for templates)

  • Increment offset by limit each page

  • Check count in response to determine total available

    • Template Personalization

    - First name: {{contact.FIRSTNAME}}
  • Last name: {{contact.LASTNAME}}

  • Custom attribute: {{contact.CUSTOM_ATTRIBUTE}}

  • Mirror link: {{mirror}}

  • Unsubscribe link: {{unsubscribe}}

    • Known Pitfalls

    Date Formats:

  • All dates use ISO 8601 with milliseconds: YYYY-MM-DDTHH:mm:ss.SSSZ

  • Pass timezone in the date-time format for accurate results

  • startDate and endDate must be used together

    • Sender Verification:

  • All sender emails must be verified in Brevo before use

  • Unverified senders cause campaign creation/update failures

  • Use GET_ALL_SENDERS to check available verified senders

    • Rate Limits:

  • Brevo API has rate limits per account plan

  • Implement backoff on 429 responses

  • Template operations have lower limits than read operations

    • Response Parsing:

  • Response data may be nested under data or data.data

  • Parse defensively with fallback patterns

  • Campaign and template IDs are numeric integers

    • Quick Reference

    TaskTool SlugKey Params
    List campaignsBREVO_LIST_EMAIL_CAMPAIGNStype, status, limit, offset
    Update campaignBREVO_UPDATE_EMAIL_CAMPAIGNcampaign_id, subject, htmlContent
    List templatesBREVO_GET_ALL_EMAIL_TEMPLATEStemplateStatus, limit, offset
    Create templateBREVO_CREATE_OR_UPDATE_EMAIL_TEMPLATEtemplateName, subject, htmlContent, sender
    Update templateBREVO_CREATE_OR_UPDATE_EMAIL_TEMPLATEtemplateId, htmlContent
    Delete templateBREVO_DELETE_EMAIL_TEMPLATEtemplateId
    List sendersBREVO_GET_ALL_SENDERS(none)