← Mailchimp support
MAILCHIMP FOR SALESFORCE · GUIDE

Mailchimp for
Agentforce.

Put your Mailchimp data to work.

Ask about audiences, understand campaign activity and make supported changes with confirmation.

Setup walkthrough + examplesFor Salesforce administrators

Mailchimp for Agentforce adds Mailchimp topics and actions to Salesforce Agentforce. Ask which audiences a lead belongs to, check campaign performance, or request a supported change without leaving Salesforce.

The integration connects

Mailchimp audiences, members and email activity with your Salesforce records.

The add-on supplies

Packaged Mailchimp topics and actions. It does not create a finished agent.

Your administrator configures

The agent, its instructions, available actions and who can use it.

Choose how your team will use it

  • In Salesforce: a dedicated Mailchimp employee agent, or Mailchimp topics added to an existing suitable agent. This guide focuses on that route.
  • In Slack: a channel on the same employee agent, with a separate Slack setup.
  • In an AI app: Salesforce Hosted MCP exposes supported actions to a connected client. This is a separate setup, not the Salesforce agent itself.

The Mailchimp Agentforce Starter ↗ provides an agent template, prerequisite checks and setup scripts your organisation can adapt. Install the managed packages first; the starter does not replace them.

Flow or Agentforce? Use Flow for a defined process, such as a scheduled audience update. Use an employee agent when a colleague wants to ask a question or request a supported task in their own words. An agent can also call a configured Flow action.

Know the source of the answer. Many lookups use data synced into Salesforce. Some actions can query Mailchimp directly. Check which action ran before treating an answer as live Mailchimp data.

Before you start

Complete these checks with your Salesforce administrator before setting up the agent.

Check your starting point
0 of 4 checkedFor your reference — this does not check your Salesforce org.

Using the scripts? Your administrator needs Salesforce CLI with the Agent plugin, Python 3 and jq, plus a local copy of the starter. The preflight checks the installed packages, permissions and available actions/topics.

Need the base app first? Follow the Mailchimp setup guide. For the Agentforce add-on installation link and supported package version, contact our team.

Setup walkthrough

Follow these seven steps with your Salesforce administrator. Each step includes a result to check before continuing.

From connection to first conversation
01Connect and check Mailchimp

Open the Mailchimp app and its setup/settings area in Salesforce. Confirm the intended Mailchimp connection is active and that its audience, members and campaign data have synced.

  1. Find the audience you will use for testing.
  2. Open a known Lead or Contact and check their Mailchimp membership outside the agent.
  3. Note the last successful sync and resolve any connection errors.

Use the setup guide and General Settings guide for connection and sync instructions.

Check before moving onYou can find the expected audience and test person in Mailchimp for Salesforce.
02Install the add-on and enable Agentforce

Install Mailchimp for Agentforce into the same org as Email Made Easy. If you need the installation route, ask Beaufort 12 for the supported package and link.

  1. In Setup → Installed Packages, confirm both packages are installed.
  2. In Setup → Einstein Setup, enable Einstein if required.
  3. In Setup → Agentforce Agents, confirm Agentforce is enabled. Einstein alone is not enough.

Salesforce availability and licensing depend on your org. Your Salesforce administrator should confirm these before proceeding.

Check before moving onBoth packages are present and the Agentforce feature is enabled. The extension supplies capabilities; an agent still needs to be configured.
03Give the test user the right access

There are separate layers of access. Give the user only the access their role needs.

  1. Package licence: confirm an active Email Made Easy licence. If licensed per user, assign it to each intended user.
  2. Mailchimp data access: assign a Mailchimp Admin, Standard or Limited permission set appropriate to the role. See User Security.
  3. Agent actions: assign Mailchimp Agent Admin (mone__Mailchimp_Agent_Admin).
  4. Record and agent access: check access to the intended Salesforce records. You will grant access to the configured agent in step 7.

The starter uses a Salesforce Employee Agent, which runs as the logged-in user. Do not set a default Agent User for this route.

Check before moving onYour test user has a package licence where required, Mailchimp data access and the separate Agent Admin permission.
04Choose your agent setup route

Already have a suitable agent? Open it in Agentforce Builder and use Add subagent → Browse AgentExchange (or the Asset Library) to add the packaged Mailchimp topics. You do not need the starter scripts or a second agent. Existing-agent instructions ↗

Want a dedicated Mailchimp agent? Use the starter below. It supplies the router, eight Mailchimp topic routes and confirmation settings. Salesforce labels vary by release; use the current employee-agent route in Agentforce Studio/Builder.

Dedicated-agent starter: commands and what they do
  1. Download or clone the public starter repository ↗ and open a terminal in its root folder.
  2. Authenticate to the intended test org with Salesforce CLI. Replace my-org throughout with your org alias.
sf org login web --alias my-org
./scripts/preflight.sh my-org

Fix any failed prerequisite checks. Then create and validate a local draft:

./scripts/create-mailchimp-agent.sh my-org \
  --name Example_Mailchimp_Agent \
  --label "Example Mailchimp Agent" \
  --company "Example Organisation" \
  --draft

Keep --draft on the first run. This generates and validates a local authoring bundle; it does not publish or activate the agent. The script aligns action inputs and outputs to the installed package.

The generated file is under force-app/main/default/aiAuthoringBundles/<ApiName>/. Avoid double quotes and backslashes inside your label or company value.

Full dedicated-agent instructions ↗

Cannot use the CLI? The same repository explains how to paste its subscriber template into the Agent Script editor of a new Employee Agent. Replace the template placeholders. If a schema/property error occurs, use the scripted route to align it with your installed package.

Check before moving onYou are configuring the intended existing agent, or have a validated draft for a new dedicated employee agent.
05Review actions, instructions and confirmation

The starter covers audience management, subscriber operations, Data Wizards, deliverability, data quality, campaign insights, engagement and automation/events. Keep the actions your team needs and test their boundaries.

  • Resolve the person and audience first. Ask for clarification if names match more than one record.
  • Keep reads separate from writes. “Which audiences is Sam on?” is a lookup, not a request to subscribe Sam.
  • Confirm each change. Tag updates, subscribing/unsubscribing, member events, follow-up tasks and creating/running Data Wizards require confirmation.
  • Preserve subscription controls. Subscribe and unsubscribe belong to the Subscriber Operations topic. A tag is a label, not evidence of consent or buying intent.
  • Report the action result. Do not claim a change succeeded unless the action returned success. Explain missing data or access instead of inventing an answer.
Review connected automations. A tag, subscription update, member event or Data Wizard can affect downstream Mailchimp workflows. Check those effects before your first write test.
Customising and preserving your starter

You can adapt the company name, agent label, welcome message and tone. Keep packaged action targets, required inputs and native confirmation settings intact. Keep subscribe/unsubscribe in Subscriber Operations.

sf agent validate authoring-bundle --json \
  --api-name Example_Mailchimp_Agent -o my-org

Do not rerun the creation script after manual edits. It overwrites the local bundle from the template. Validate and publish your edited bundle directly instead. Package upgrades do not rewrite your customer-owned agent; review starter changes before merging them.

Customisation instructions ↗

Check before moving onThe enabled actions match your use case, ambiguous names prompt a question and every write has a confirmation step.
06Preview, cancel and verify

Start with an audience or membership lookup. Then test one permitted change with a test record and a tag that does not trigger live automations.

Starter users: publish for testing without activation

The local draft must be published before that version can be tested in the builder.

  • Unmodified draft: rerun the creation command with the same name, label and company, replacing --draft with --no-activate. This publishes the agent, deploys its access permission set and assigns permissions to the administrator running the script. It leaves the agent inactive.
  • Manually edited draft: validate it, then publish the edited bundle directly:
sf agent publish authoring-bundle --json \
  --api-name Example_Mailchimp_Agent --skip-retrieve -o my-org

The direct command does not activate the agent or create the starter’s access permission set. Configure agent access in step 7.

Omitting both flags from the creation script publishes and activates. Use the inactive route while reviewing and testing.

  1. Ask for your test person’s audience membership. Compare the answer with the Salesforce Mailchimp record.
  2. Try a deliberately ambiguous name. The agent should ask which person or audience you mean.
  3. Ask to add one test tag. Read the exact person, audience and tag in the confirmation; choose Cancel and verify no tag changed.
  4. Repeat and confirm once. Check the action result and the actual tag before trying anything else.
  5. Repeat key lookups as the intended user. An administrator’s successful preview does not prove every user has the same access.

Preview can run real actions. Use a suitable test environment and test records.

Mailchimp Agent in Salesforce reporting the audience membership of Sam Taylor Demo
A read-only membership lookup based on the latest synced Salesforce data. Salesforce demonstration using fictional data. View full size ↗
Check before moving onLookups match the source, changes require confirmation, and cancelled or unauthorised requests do not change data.
07Activate and try it as your user
  1. Activate the reviewed, tested agent version.
  2. In Setup → Permission Sets, open the generated <Agent label> Access permission set, or your own agent-access set. Enable the agent under Agent Access and assign it to the intended users.
  3. Confirm the licence, Mailchimp permissions, connection and record access from step 3. Log out and back in after permission changes if the builder or panel has not picked them up.
  4. In Salesforce Lightning, open the Agentforce panel and select your Mailchimp Agent.
  5. Try the request below with your own test record, then compare the result with the source.
Your first requestWhich Mailchimp audiences does [test person’s name] belong to, and what is their subscription status? Use the synced Salesforce data and keep this read-only.
Check before moving onThe intended user can see the agent and receive the correct membership result. Roll out to the wider team after these checks pass.

What the agent can do

Your installed package, enabled actions and user permissions determine which requests are available.

Find

People and audiences

Find the right Lead or Contact, audience membership and stored tags.

Understand

Campaigns and engagement

Review available campaign summaries, per-person activity and deliverability information.

Act

Confirmed changes

Manage tags or subscriptions, create follow-up tasks and work with Data Wizards when enabled.

Keep campaign and person-level results separate. A campaign’s open rate is not proof that a particular person opened it. Missing synced activity is not proof of no engagement. Tags describe stored labels; they do not establish interest, intent or consent.

Interactive examples

Work through three illustrative conversations. Start with a read-only question, inspect the expected response and see how to verify it. The optional tag change is a separate request.

Interactive examplesFictional data · no connection to your org

Find the audience membership

Before you try it: An accessible test Lead or Contact and a connected, synced audience.

Ask a precise question

Your requestWhich audiences does Sam Taylor (Demo) belong to, and what is his subscription status? Use the synced Salesforce data and keep it read-only.

Check the source and match

Illustrative response

Sam Taylor (Demo) belongs to Northstar Product Updates (Demo) and is subscribed according to the latest synced Salesforce data.

No membership has been changed.

If several people match, the agent should ask you to choose.

Verify in Salesforce

  1. Open Sam’s Lead record and its Mailchimp membership information.
  2. Compare the audience and subscription status.
  3. Check the last sync. If you need a current Mailchimp answer, request the live status action where your agent supports it.

Read campaign performance in context

Before you try it: A known campaign available to your configured campaign-summary action.

Name the campaign

Your requestGive me the campaign-level report for Northstar – October Product Launch (Demo): recipients, open rate and click rate. Keep it concise and read-only.

Read campaign totals

Illustrative response

Northstar – October Product Launch (Demo)

Recipients
120
Open rate
60%
Click rate
20%

These are campaign-level totals, not Sam’s individual activity.

Verify the report

Open the same campaign’s report and compare the period, recipient count and rates. Check data freshness before comparing with Mailchimp. Do not infer a particular person’s behaviour or consent from these totals.

Make a specific, confirmed tag change

Before you try it: A test audience, an existing test subscriber and a tag with no live automation attached.

Request one change

Your requestAdd the tag Guide Test to Sam Taylor (Demo) in Northstar Product Updates (Demo). Keep all existing tags.

Review the proposed change

Illustrative confirmation

Add Guide Test to Sam Taylor (Demo) in Northstar Product Updates (Demo)?

Keep existing tags. Do not change subscription status.

These controls only change this illustration. They do not update Salesforce or Mailchimp.

Check the reported result

Illustrative successful resultThe action returned success: Guide Test was added. Existing tags and subscription status were left unchanged.

In a real conversation, an unsuccessful or missing action result must not be presented as a completed update.

Verify before continuing

  1. Check the member’s tags in Mailchimp and confirm Guide Test is present.
  2. Check that existing tags remain and the subscription status has not changed.
  3. If an action failed or timed out, inspect the actual record before retrying.

Illustrative responses, not live product output. Your agent’s wording and available results depend on its configuration and permissions.

See it in Salesforce

These screenshots show a configured Mailchimp Agent using fictional Salesforce records. Open an image to inspect it at full size.

A compact member profile

The agent brings together audience membership, subscription status and stored tags. Notice that it treats tags as labels, not evidence of buying intent.

Mailchimp Agent in Salesforce showing Sam Taylor Demo audience, subscription status and stored tags
A member profile alongside the Lead’s Mailchimp information. Salesforce demonstration using fictional data. View full size ↗

A campaign-level report

The answer summarises one named campaign. Its totals describe the campaign, not the individual Lead open behind the conversation.

Mailchimp Agent showing a fictional campaign report with 120 recipients, 60 percent opens and 20 percent clicks
Campaign summary with synthetic demonstration totals. Salesforce demonstration using fictional data. View full size ↗

Troubleshooting

Use the symptom to separate connection, access and agent-configuration problems.

What you seeWhat to check
Agentforce or preflight is unavailableCheck the org alias, Salesforce CLI/Agent plugin, Python 3 and jq. Confirm both packages and the separate Agentforce toggle; enabling Einstein alone is not sufficient.
Actions or topics are missingConfirm Mailchimp for Agentforce is installed in this org and your package version is supported. Follow preflight output rather than assuming a fixed action count.
The agent cannot find a known audience or personCheck the correct audience, exact person, connection, last sync and user access. Some actions read synced Salesforce data; use a supported live lookup when a current Mailchimp status is needed.
The agent is missing from the panelA local starter draft is not published or active. Check the activated version, the user’s Agent Access permission set and the user’s Salesforce Agentforce access. Refresh the session after access changes.
One user cannot read Mailchimp dataCheck their Email Made Easy package licence, Mailchimp data permission set, Mailchimp Agent Admin and access to the relevant Salesforce records.
Publishing fails on a property or LightningTypeA pasted template may not match the installed package schema. Use the starter’s alignment route, preserving any manual edits before regeneration.
A requested change fails or is blockedRead the action result and any warning. Check the exact person/audience, permissions and subscription rules. Verify the record before retrying; do not work around an opt-out.
Hosted MCP connects but no tools appearUse the separate MCP guide to check OAuth, named-user JWT settings and server configuration. If tools appear but packaged-object reads fail, check the signed-in user’s active Email Made Easy licence and reconnect.

Still stuck? Send our team the package versions, failed step, exact error and whether one user or everyone is affected. Do not include passwords, OAuth tokens or other credentials.

Common questions

Do I need the starter if I already have an agent?
No. Add the packaged Mailchimp topics through AgentExchange or the Asset Library, then configure access and test the actions. Follow the existing-agent route ↗
Does --draft change anything in Salesforce?
For the employee-agent creation script, --draft generates and validates a local bundle without publishing or activating the agent. The separate Hosted MCP script has different behaviour: --draft deploys an inactive server, so it is not a no-change preview.
Can I use the same agent in Slack?
Yes, when your org and Slack workspace meet the prerequisites. Slack is a channel on the Mailchimp employee agent. Create and test that agent first, then follow the Slack setup guide ↗.
Can I use Claude or ChatGPT?
The starter includes a separate Salesforce Hosted MCP route. The supplied client setup is documented for Claude; other MCP clients need their own supported configuration. Hosted MCP runs the packaged actions as the signed-in user and does not use the employee agent’s Agent Script. Begin with the supported read-only tool set when you only need answers. Hosted MCP setup ↗
Are all answers live from Mailchimp?
No. Many questions use synced Salesforce data, while certain actions can query Mailchimp directly. Check the source and last sync; missing activity is not proof that someone did not engage.
Does adding a tag subscribe someone?
No. Tags and subscription status are different. A stored tag does not establish consent. Subscriber Operations handles explicit subscribe/unsubscribe requests with confirmation and applicable subscription controls.
Will the agent send a campaign for me?
The starter’s campaign examples focus on finding, summarising and comparing available campaign information. Do not present a member event or a tag change as a campaign-send action. Those changes may still trigger automations already configured in Mailchimp.
Do package upgrades update my customised agent?
They update packaged Apex and topics, not your customer-owned agent script. Review starter releases, preserve your edits, validate and test before publishing a new version.
NEXT GUIDE

Invocable actions

Use Mailchimp actions in Salesforce Flow.

All Mailchimp support guidesStill need a hand?
Mailchimp supportFor Salesforce · By Beaufort 12

How can we help?

Guides, answers and a little human help.

Explore the support guidesSetup, features and troubleshooting Contact the teamSend us a message