{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-agen-for-work/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["Notification"]},"type":"markdown"},"seo":{"title":"Brevo integration","siteUrl":"https://developers.frontegg.com/","llmstxt":{"title":"Frontegg Developer Documentation","description":"Authentication, authorization, and user management for Customer Identity, plus Agen for SaaS and Agen for Work. Guides, SDKs, and API references.","sections":[{"title":"Customer Identity (CIAM)","description":"Auth, SSO, SCIM, entitlements, and user management — guides, SDKs, and APIs.","includeFiles":["ciam/**/*.md"],"excludeFiles":[]},{"title":"Agen for SaaS","description":"Agentic access and authorization for SaaS products.","includeFiles":["agen-for-saas/**/*.md"],"excludeFiles":[]},{"title":"Agen for Work","description":"Agentic access and authorization for internal and workforce use.","includeFiles":["agen-for-work/**/*.md"],"excludeFiles":[]},{"title":"Platform","description":"Shared platform overview.","includeFiles":["platform/**/*.md"],"excludeFiles":[]}],"excludeFiles":["internal-docs/**","ciam/guides/env-settings/inject-client-ip.md","CLAUDE.md",".claude/**","**/images/**"],"hide":false}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"brevo-integration","__idx":0},"children":["Brevo integration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Brevo (formerly Sendinblue) is an email marketing, CRM, and automation platform. Integrating Brevo with Frontegg lets your application manage contacts and lists, create and send campaigns, and work with templates, senders, and webhooks on behalf of your users — all through Frontegg's integration layer using Brevo's OAuth 2.0 authorization."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Notification","attributes":{"title":"Prerequisites","type":"attention"},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://www.brevo.com/"},"children":["Brevo"]}," account"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://nodejs.org/"},"children":["Node.js"]}," (for npm/yarn) or ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://brew.sh/"},"children":["Homebrew"]}," to install the Brevo CLI"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"connect-brevo","__idx":1},"children":["Connect Brevo"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Brevo OAuth 2.0 applications are created with the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Brevo CLI"]},", not a web dashboard. The CLI generates your ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client ID"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client Secret"]}," and registers the redirect URL that Brevo returns users to after they authorize access."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-1-install-the-brevo-cli","__idx":2},"children":["Step 1: Install the Brevo CLI"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Install the CLI using your preferred package manager:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"npm install -g @getbrevo/cli\n# or: yarn global add @getbrevo/cli\n# or: brew install getbrevo/tap/brevo\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-2-log-in-to-brevo","__idx":3},"children":["Step 2: Log in to Brevo"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Authenticate the CLI with your Brevo account. This opens a browser sign-in and saves your credentials to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["~/.brevo/credentials.json"]},"."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"brevo login\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-3-create-the-oauth-application","__idx":4},"children":["Step 3: Create the OAuth application"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Run the guided setup and follow the prompts:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"brevo app init\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When prompted, provide:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["App name"]}," — A descriptive name, for example ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Frontegg Integration"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Distribution type"]}," — Choose ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["public"]}," if the app will connect multiple Brevo accounts through Frontegg."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["OAuth callback URL"]}," — Enter your Frontegg Redirect URL:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://YOUR_MCP_GATEWAY_URL/integration-callback"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-4-set-the-required-scopes","__idx":5},"children":["Step 4: Set the required scopes"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["New apps are seeded with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["contacts:read"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["contacts:write"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["crm:read"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["crm:write"]},". Add the remaining scopes this integration uses — email campaigns, transactional email templates, account senders, and webhooks:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"brevo app update \\\n  --scope campaigns.email:read --scope campaigns.email:write \\\n  --scope transactional.email:read \\\n  --scope account:read --scope account:write \\\n  --scope webhooks:read --scope webhooks:write\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Run ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["brevo app available-scopes"]}," to see every scope you can grant."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-5-copy-the-client-id-and-client-secret","__idx":6},"children":["Step 5: Copy the Client ID and Client Secret"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The CLI writes your ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["client_id"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["client_secret"]}," to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["src/oauth/.env.local"]},". Open that file and copy both values."]},{"$$mdtype":"Tag","name":"Notification","attributes":{"title":"Keep your Client Secret safe","type":"attention"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".env.local"]}," file is gitignored for a reason — never commit it. Store the Client Secret on the server side only and never expose it in client-side code."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"configure-the-frontegg-portal","__idx":7},"children":["Configure the Frontegg portal"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once you have your ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client ID"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client Secret"]},", configure the integration in the Frontegg portal:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Open the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Frontegg portal"]}," and navigate to [ENVIRONMENT] → Integrations → Brevo."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client ID"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client Secret"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select the required ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["scopes"]},":"]}]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Scope"},"children":["Scope"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["contacts:read"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read contacts and lists"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["contacts:write"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Create, update, and delete contacts and lists"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["campaigns.email:read"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read email campaigns"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["campaigns.email:write"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Create, update, and send email campaigns"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transactional.email:read"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read email templates"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["account:read"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read account senders"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["account:write"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Create and manage account senders"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["webhooks:read"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read webhooks"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["webhooks:write"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Create and delete webhooks"]}]}]}]}]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":4},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When a user connects their Brevo account, Brevo shows a consent screen listing these permissions before granting access."]},{"$$mdtype":"Tag","name":"Notification","attributes":{"title":"Keep your credentials secure","type":"attention"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Never share or commit your Client Secret to version control."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"additional-resources","__idx":8},"children":["Additional resources"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developers.brevo.com/docs/oauth-quickstart"},"children":["Brevo OAuth 2.0 quickstart"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developers.brevo.com/docs/oauth-integration-guide"},"children":["Brevo OAuth 2.0 integration guide"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/agen-for-work/connectors/redirect-url"},"children":["How to get your Redirect URL"]}]}]}]}]},"headings":[{"value":"Brevo integration","id":"brevo-integration","depth":2},{"value":"Connect Brevo","id":"connect-brevo","depth":3},{"value":"Step 1: Install the Brevo CLI","id":"step-1-install-the-brevo-cli","depth":4},{"value":"Step 2: Log in to Brevo","id":"step-2-log-in-to-brevo","depth":4},{"value":"Step 3: Create the OAuth application","id":"step-3-create-the-oauth-application","depth":4},{"value":"Step 4: Set the required scopes","id":"step-4-set-the-required-scopes","depth":4},{"value":"Step 5: Copy the Client ID and Client Secret","id":"step-5-copy-the-client-id-and-client-secret","depth":4},{"value":"Configure the Frontegg portal","id":"configure-the-frontegg-portal","depth":3},{"value":"Additional resources","id":"additional-resources","depth":3}],"frontmatter":{"category":"Marketing","seo":{"title":"Brevo integration"}},"lastModified":"2026-07-23T10:20:13.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/agen-for-work/connectors/marketplace/brevo","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}