Connect Salesforce to AmpUp: what syncs, how often, what AmpUp writes back, and how to fix common setup issues
Connect your Salesforce org to AmpUp to sync accounts, opportunities, and activity data. AmpUp uses this context for pre-call briefs, coaching, and practice, and logs a summary of every analyzed meeting back to Salesforce.
Follow the prompts in Salesforce to complete the installation.
2
Configure Objects in AmpUp
Go to the Salesforce tile on the AmpUp Tools page and click Continue to Configure.
Salesforce Configuration
For each object listed, click Save. These are the objects AmpUp will pull from Salesforce.
3
Choose how much history to import
Pick a backfill window for the first sync. The default is 30 days; you can choose anything from 1 day to a full year, a custom range, or full history. Longer windows take longer to finish the first import.
4
Set up post-meeting updates (optional)
Choose which Opportunity, Account, and Contact fields AmpUp should fill in after meetings, and give each one a short instruction describing what to extract. If you skip this step, AmpUp uses the default fields listed in What AmpUp writes back.
Name, industry, type, owner, billing city and country
Opportunity
Deal context, stage, and forecast inputs
Name, amount, close date, stage, probability, forecast category, type, lead source, next step, description, account, owner, campaign, created and last-modified dates
Event
Meetings, linked to the opportunity or account they relate to
Subject, date, end time, description, location, owner, related contact and record, event subtype
Task
Activity history for a deal
Subject, description, status, priority, due date, type, owner, related contact and record
EmailMessage
Email history for a deal
Subject, sender and recipients, date, body, thread, related record
Note
Existing notes on a record
Title, body, owner, parent record
AmpUp also looks up Users (to match record owners to AmpUp users by email) and Contacts and Opportunity Contact Roles (to identify meeting attendees and buying-committee roles) when it needs them, rather than on a schedule.
Direction: Salesforce is the system of record. AmpUp reads the objects above and writes back only the items listed in the next section.
Frequency: AmpUp checks Salesforce for new and changed records every 20 minutes. A change made in Salesforce appears in AmpUp within about 20 minutes.
First sync: after you connect, AmpUp imports records from the backfill window you chose. If a meeting refers to an opportunity or account that has not synced yet, AmpUp fetches that record on demand.
Refreshing a single deal: from a deal in AmpUp you can refresh it on demand, which re-pulls its contact roles, contacts, tasks, events, emails, and notes.
After AmpUp analyzes an external meeting, it adds one Salesforce Note with the meeting title, date, attendees, outcome, summary, key points, and links to the AmpUp meeting and recording. The note is attached to the meeting’s opportunity, or to the account or contact when there is no opportunity. Each meeting is logged once.
Post-meeting field updates
AmpUp extracts values for your mapped fields from each meeting and creates an Update CRM task. You review and edit the values, then approve them to write them to Salesforce.When a rep completes a voice debrief, AmpUp writes the extracted values directly, without the review step. This is controlled by Auto-update after meeting debrief in the Salesforce settings, which is on by default.If you have not mapped your own fields, AmpUp updates these by default:
Object
Default fields
Opportunity
Stage, Next Step, Description
Account
Description
Contact
Description
Field updates replace the existing value rather than appending to it. If your team uses the Description fields for something else, map different fields in the post-meeting updates step before turning on auto-update.
Records you create or edit in AmpUp
When you create an opportunity or account in AmpUp with CRM sync on, edit deal fields or stage, add or remove contact roles, or add a contact, AmpUp makes the same change in Salesforce. If a meeting attendee has no matching Salesforce contact, AmpUp can create one from their name and email.
Deleting an opportunity in AmpUp also deletes it in Salesforce.
Follow-up tasks you create in AmpUp stay in AmpUp; they are not created as Salesforce Tasks.
AmpUp connects through Salesforce OAuth and requests the api, refresh_token, and full scopes. It acts as the user who authorized the connection, so that user’s profile and permission sets decide which records AmpUp can see and edit. Use a user with read access to every object in What AmpUp reads and edit access to the fields you map for post-meeting updates.
AmpUp links a Salesforce Event to a deal through its Related To field. Set Related To to the opportunity (or its account) when you log the event. If an event is related only to an account that has exactly one opportunity, AmpUp uses that opportunity. Otherwise the meeting has no deal, and AmpUp skips field updates and the meeting note for it.
Record owners don't match AmpUp users
Owners are matched by email. Make sure each rep’s Salesforce User email matches the email they use to sign in to AmpUp. Users without an email are skipped.
An attendee is missing from a meeting
AmpUp matches attendees to Salesforce Contacts. Leads are not matched as attendees, so convert the lead to a contact if you want them tracked on the deal. AmpUp reads one related contact per event.
A new contact wasn't created in Salesforce
AmpUp creates Salesforce contacts only for attendees with an email address.
The field picker says "No fields found from CRM"
The connection is missing or the connecting user can’t read field metadata. Reconnect Salesforce from the Tools page, and check that the user has access to the Opportunity, Account, and Contact objects.
Adding a contact role fails
Contact role values must exist in your org’s Opportunity Contact Role picklist. Add the role in Salesforce Setup, or pick an existing one.
The connection shows an error
Reconnect Salesforce from the Tools page. If the connecting user was deactivated or lost API access, authorize again with a different admin.
{"docsConfig":{"$schema":"https://mintlify.com/docs.json","theme":"mint","name":"AmpUp Documentation","colors":{"primary":"#2563EB","light":"#3B82F6","dark":"#1E40AF"},"favicon":"https://mintcdn.com/ampup/1EWrNKsJLK8V4F34/favicon.svg?fit=max\u0026auto=format\u0026n=1EWrNKsJLK8V4F34\u0026q=85\u0026s=c7848aa67705c7851517122e69b67e6b","logo":{"light":"https://mintcdn.com/ampup/CfEu0QltGPzGd3og/logo/light.svg?fit=max\u0026auto=format\u0026n=CfEu0QltGPzGd3og\u0026q=85\u0026s=4fe7377c117cd632347db0b16517ab76","dark":"https://mintcdn.com/ampup/CfEu0QltGPzGd3og/logo/dark.svg?fit=max\u0026auto=format\u0026n=CfEu0QltGPzGd3og\u0026q=85\u0026s=87d6de0aada0425bff5b3f0cfc3bf5fe"},"navbar":{"links":[{"label":"Support","href":"mailto:support@ampup.ai"}],"primary":{"type":"button","label":"Get Started","href":"https://www.ampup.ai"}},"seo":{"metatags":{"og:type":"website","og:site_name":"AmpUp Documentation","twitter:card":"summary_large_image"},"indexing":"all"},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/ampup-ai"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"ampup","hasAudioNarration":false,"actualSubdomain":"ampup","customDomains":["docs.ampup.ai"],"gitSource":{"type":"github","owner":"a79-ai","repo":"ampup-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6ad5b154b9a0635706e669d1","clientVersion":"0.0.4094","searchFilterCounts":[{"language":"default","tag":"Documentation","count":38},{"language":"default","tag":"Integrations","count":32},{"language":"default","tag":"Developer","count":12},{"language":"default","tag":"Conversation Intelligence","count":9},{"language":"default","tag":"Chat Widget","count":4},{"language":"default","tag":"Getting Started","count":3},{"language":"default","tag":"CRM Platforms","count":3},{"language":"default","tag":"Meeting Platforms","count":2},{"language":"default","tag":"memstore","count":2},{"language":"default","tag":"Security","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"integrations/salesforce","slug":"/integrations/salesforce","pageMetadata":{"title":"Salesforce","description":"Connect Salesforce to AmpUp: what syncs, how often, what AmpUp writes back, and how to fix common setup issues","icon":"cloud","href":"/integrations/salesforce"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Connect Salesforce to AmpUp: what syncs, how often, what AmpUp writes back, and how to fix common setup issues\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Accordion,AccordionGroup,Check,CodeBlock,Frame,Heading,OptimizedImage,Step,Steps,Table,Warning}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!AccordionGroup)_missingMdxReference(`AccordionGroup`,true);if(!Check)_missingMdxReference(`Check`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Connect your Salesforce org to AmpUp to sync accounts, opportunities, and activity data. AmpUp uses this context for pre-call briefs, coaching, and practice, and logs a summary of every analyzed meeting back to Salesforce.`}),`\n`,_jsx(Heading,{level:`2`,id:`prerequisites`,children:`Prerequisites`}),`\n`,_jsx(_components.p,{children:`Before connecting Salesforce, ensure you have:`}),`\n`,_jsx(Check,{children:`Salesforce admin permissions to install packages`}),`\n`,_jsx(Check,{children:`A Salesforce edition with API access, and a connecting user who can read and edit the objects listed below`}),`\n`,_jsx(Check,{children:`AmpUp admin access for your organization`}),`\n`,_jsx(Heading,{level:`2`,id:`connect-salesforce`,children:`Connect Salesforce`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Install the AmpUp Salesforce Package`,children:[_jsx(_components.p,{children:`Install the AmpUp managed package into your Salesforce org using the link below:`}),_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`https://login.salesforce.com/packaging/installPackage.apexp?p0=04tg50000004SddAAE`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsx(_components.p,{children:`Follow the prompts in Salesforce to complete the installation.`})]}),_jsxs(Step,{title:`Configure Objects in AmpUp`,children:[_jsxs(_components.p,{children:[`Go to the Salesforce tile on the `,_jsx(_components.a,{href:`https://app.ampup.ai/maxima/tools`,children:`AmpUp Tools page`}),` and click `,_jsx(_components.strong,{children:`Continue to Configure`}),`.`]}),_jsx(Frame,{caption:`Salesforce Configuration`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/ampup/JGceCnwStsQNHKdQ/images/integrations/salesforce-config.png?fit=max\u0026auto=format\u0026n=JGceCnwStsQNHKdQ\u0026q=85\u0026s=2ead026f2cf417157ca5075b4e558d3f`,alt:`Configure Salesforce Integration`,\"data-og-width\":`3456`,width:`3456`,\"data-og-height\":`1776`,height:`1776`,\"data-path\":`images/integrations/salesforce-config.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/ampup/JGceCnwStsQNHKdQ/images/integrations/salesforce-config.png?w=280\u0026fit=max\u0026auto=format\u0026n=JGceCnwStsQNHKdQ\u0026q=85\u0026s=9e93751e7844272fbd06b37f80969eeb 280w, https://mintcdn.com/ampup/JGceCnwStsQNHKdQ/images/integrations/salesforce-config.png?w=560\u0026fit=max\u0026auto=format\u0026n=JGceCnwStsQNHKdQ\u0026q=85\u0026s=7c48f90df2ea4846c99eacd7320d55eb 560w, https://mintcdn.com/ampup/JGceCnwStsQNHKdQ/images/integrations/salesforce-config.png?w=840\u0026fit=max\u0026auto=format\u0026n=JGceCnwStsQNHKdQ\u0026q=85\u0026s=ef7e3461e12cae71884198b03f07b7ef 840w, https://mintcdn.com/ampup/JGceCnwStsQNHKdQ/images/integrations/salesforce-config.png?w=1100\u0026fit=max\u0026auto=format\u0026n=JGceCnwStsQNHKdQ\u0026q=85\u0026s=b44456d9e600681187239bd3f3e75f65 1100w, https://mintcdn.com/ampup/JGceCnwStsQNHKdQ/images/integrations/salesforce-config.png?w=1650\u0026fit=max\u0026auto=format\u0026n=JGceCnwStsQNHKdQ\u0026q=85\u0026s=a389d2bbdf7f4f735338cb73dfdb8765 1650w, https://mintcdn.com/ampup/JGceCnwStsQNHKdQ/images/integrations/salesforce-config.png?w=2500\u0026fit=max\u0026auto=format\u0026n=JGceCnwStsQNHKdQ\u0026q=85\u0026s=460111c7d25093802a707fdbe6fe18c4 2500w`})}),_jsxs(_components.p,{children:[`For each object listed, click `,_jsx(_components.strong,{children:`Save`}),`. These are the objects AmpUp will pull from Salesforce.`]})]}),_jsx(Step,{title:`Choose how much history to import`,children:_jsx(_components.p,{children:`Pick a backfill window for the first sync. The default is 30 days; you can choose anything from 1 day to a full year, a custom range, or full history. Longer windows take longer to finish the first import.`})}),_jsx(Step,{title:`Set up post-meeting updates (optional)`,children:_jsxs(_components.p,{children:[`Choose which Opportunity, Account, and Contact fields AmpUp should fill in after meetings, and give each one a short instruction describing what to extract. If you skip this step, AmpUp uses the default fields listed in `,_jsx(_components.a,{href:`#what-ampup-writes-back`,children:`What AmpUp writes back`}),`.`]})})]}),`\n`,_jsx(Heading,{level:`2`,id:`what-ampup-reads-from-salesforce`,children:`What AmpUp reads from Salesforce`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Object`}),_jsx(_components.th,{children:`What AmpUp uses it for`}),_jsx(_components.th,{children:`Fields read`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Account`}),_jsx(_components.td,{children:`Account context in briefs and coaching`}),_jsx(_components.td,{children:`Name, industry, type, owner, billing city and country`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Opportunity`}),_jsx(_components.td,{children:`Deal context, stage, and forecast inputs`}),_jsx(_components.td,{children:`Name, amount, close date, stage, probability, forecast category, type, lead source, next step, description, account, owner, campaign, created and last-modified dates`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Event`}),_jsx(_components.td,{children:`Meetings, linked to the opportunity or account they relate to`}),_jsx(_components.td,{children:`Subject, date, end time, description, location, owner, related contact and record, event subtype`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Task`}),_jsx(_components.td,{children:`Activity history for a deal`}),_jsx(_components.td,{children:`Subject, description, status, priority, due date, type, owner, related contact and record`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`EmailMessage`}),_jsx(_components.td,{children:`Email history for a deal`}),_jsx(_components.td,{children:`Subject, sender and recipients, date, body, thread, related record`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Note`}),_jsx(_components.td,{children:`Existing notes on a record`}),_jsx(_components.td,{children:`Title, body, owner, parent record`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`AmpUp also looks up `,_jsx(_components.strong,{children:`Users`}),` (to match record owners to AmpUp users by email) and `,_jsx(_components.strong,{children:`Contacts`}),` and `,_jsx(_components.strong,{children:`Opportunity Contact Roles`}),` (to identify meeting attendees and buying-committee roles) when it needs them, rather than on a schedule.`]}),`\n`,_jsx(Heading,{level:`2`,id:`how-sync-works`,children:`How sync works`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Direction:`}),` Salesforce is the system of record. AmpUp reads the objects above and writes back only the items listed in the next section.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Frequency:`}),` AmpUp checks Salesforce for new and changed records every 20 minutes. A change made in Salesforce appears in AmpUp within about 20 minutes.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`First sync:`}),` after you connect, AmpUp imports records from the backfill window you chose. If a meeting refers to an opportunity or account that has not synced yet, AmpUp fetches that record on demand.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Refreshing a single deal:`}),` from a deal in AmpUp you can refresh it on demand, which re-pulls its contact roles, contacts, tasks, events, emails, and notes.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`what-ampup-writes-back`,children:`What AmpUp writes back`}),`\n`,_jsxs(AccordionGroup,{children:[_jsx(Accordion,{title:`Meeting notes (automatic)`,id:`meeting-notes-automatic`,children:_jsxs(_components.p,{children:[`After AmpUp analyzes an external meeting, it adds one Salesforce `,_jsx(_components.strong,{children:`Note`}),` with the meeting title, date, attendees, outcome, summary, key points, and links to the AmpUp meeting and recording. The note is attached to the meeting’s opportunity, or to the account or contact when there is no opportunity. Each meeting is logged once.`]})}),_jsxs(Accordion,{title:`Post-meeting field updates`,id:`post-meeting-field-updates`,children:[_jsxs(_components.p,{children:[`AmpUp extracts values for your mapped fields from each meeting and creates an `,_jsx(_components.strong,{children:`Update CRM`}),` task. You review and edit the values, then approve them to write them to Salesforce.`]}),_jsxs(_components.p,{children:[`When a rep completes a voice debrief, AmpUp writes the extracted values directly, without the review step. This is controlled by `,_jsx(_components.strong,{children:`Auto-update after meeting debrief`}),` in the Salesforce settings, which is on by default.`]}),_jsx(_components.p,{children:`If you have not mapped your own fields, AmpUp updates these by default:`}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Object`}),_jsx(_components.th,{children:`Default fields`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Opportunity`}),_jsx(_components.td,{children:`Stage, Next Step, Description`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Account`}),_jsx(_components.td,{children:`Description`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Contact`}),_jsx(_components.td,{children:`Description`})]})]})]}),_jsx(Warning,{children:_jsx(_components.p,{children:`Field updates replace the existing value rather than appending to it. If your team uses the Description fields for something else, map different fields in the post-meeting updates step before turning on auto-update.`})})]}),_jsxs(Accordion,{title:`Records you create or edit in AmpUp`,id:`records-you-create-or-edit-in-ampup`,children:[_jsx(_components.p,{children:`When you create an opportunity or account in AmpUp with CRM sync on, edit deal fields or stage, add or remove contact roles, or add a contact, AmpUp makes the same change in Salesforce. If a meeting attendee has no matching Salesforce contact, AmpUp can create one from their name and email.`}),_jsx(Warning,{children:_jsx(_components.p,{children:`Deleting an opportunity in AmpUp also deletes it in Salesforce.`})})]})]}),`\n`,_jsx(_components.p,{children:`Follow-up tasks you create in AmpUp stay in AmpUp; they are not created as Salesforce Tasks.`}),`\n`,_jsx(Heading,{level:`2`,id:`permissions`,children:`Permissions`}),`\n`,_jsxs(_components.p,{children:[`AmpUp connects through Salesforce OAuth and requests the `,_jsx(_components.code,{children:`api`}),`, `,_jsx(_components.code,{children:`refresh_token`}),`, and `,_jsx(_components.code,{children:`full`}),` scopes. It acts as the user who authorized the connection, so that user’s profile and permission sets decide which records AmpUp can see and edit. Use a user with read access to every object in `,_jsx(_components.a,{href:`#what-ampup-reads-from-salesforce`,children:`What AmpUp reads`}),` and edit access to the fields you map for post-meeting updates.`]}),`\n`,_jsx(Heading,{level:`2`,id:`troubleshooting`,children:`Troubleshooting`}),`\n`,_jsxs(AccordionGroup,{children:[_jsx(Accordion,{title:`Meetings aren't linked to the right opportunity`,id:`meetings-arent-linked-to-the-right-opportunity`,children:_jsxs(_components.p,{children:[`AmpUp links a Salesforce Event to a deal through its `,_jsx(_components.strong,{children:`Related To`}),` field. Set Related To to the opportunity (or its account) when you log the event. If an event is related only to an account that has exactly one opportunity, AmpUp uses that opportunity. Otherwise the meeting has no deal, and AmpUp skips field updates and the meeting note for it.`]})}),_jsx(Accordion,{title:`Record owners don't match AmpUp users`,id:`record-owners-dont-match-ampup-users`,children:_jsx(_components.p,{children:`Owners are matched by email. Make sure each rep’s Salesforce User email matches the email they use to sign in to AmpUp. Users without an email are skipped.`})}),_jsx(Accordion,{title:`An attendee is missing from a meeting`,id:`an-attendee-is-missing-from-a-meeting`,children:_jsx(_components.p,{children:`AmpUp matches attendees to Salesforce Contacts. Leads are not matched as attendees, so convert the lead to a contact if you want them tracked on the deal. AmpUp reads one related contact per event.`})}),_jsx(Accordion,{title:`A new contact wasn't created in Salesforce`,id:`a-new-contact-wasnt-created-in-salesforce`,children:_jsx(_components.p,{children:`AmpUp creates Salesforce contacts only for attendees with an email address.`})}),_jsx(Accordion,{title:`The field picker says \"No fields found from CRM\"`,id:`the-field-picker-says-no-fields-found-from-crm`,children:_jsx(_components.p,{children:`The connection is missing or the connecting user can’t read field metadata. Reconnect Salesforce from the Tools page, and check that the user has access to the Opportunity, Account, and Contact objects.`})}),_jsx(Accordion,{title:`Adding a contact role fails`,id:`adding-a-contact-role-fails`,children:_jsx(_components.p,{children:`Contact role values must exist in your org’s Opportunity Contact Role picklist. Add the role in Salesforce Setup, or pick an existing one.`})}),_jsx(Accordion,{title:`The connection shows an error`,id:`the-connection-shows-an-error`,children:_jsxs(_components.p,{children:[`Reconnect Salesforce from the `,_jsx(_components.a,{href:`https://app.ampup.ai/maxima/tools`,children:`Tools page`}),`. If the connecting user was deactivated or lost API access, authorize again with a different admin.`]})})]}),`\n`,_jsx(Heading,{level:`2`,id:`related`,children:`Related`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/integrations/hubspot`,children:`HubSpot`}),`, if part of your team runs on HubSpot`]}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/integrations/overview`,children:`Integrations overview`})}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`https://www.ampup.ai/integrations/salesforce`,children:`AmpUp for Salesforce`}),`: how AmpUp works alongside Salesforce`]}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Salesforce","description":"Connect Salesforce to AmpUp: what syncs, how often, what AmpUp writes back, and how to fix common setup issues","icon":"cloud","href":"/integrations/salesforce"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Prerequisites","slug":"prerequisites","depth":2,"children":[]},{"title":"Connect Salesforce","slug":"connect-salesforce","depth":2,"children":[]},{"title":"What AmpUp reads from Salesforce","slug":"what-ampup-reads-from-salesforce","depth":2,"children":[]},{"title":"How sync works","slug":"how-sync-works","depth":2,"children":[]},{"title":"What AmpUp writes back","slug":"what-ampup-writes-back","depth":2,"children":[]},{"title":"Permissions","slug":"permissions","depth":2,"children":[]},{"title":"Troubleshooting","slug":"troubleshooting","depth":2,"children":[]},{"title":"Related","slug":"related","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"ampup","siteName":"AmpUp Documentation","title":"Salesforce - AmpUp Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-22T23:17:47.651Z","originalFileLocation":"integrations/salesforce.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Connect Salesforce to AmpUp: what syncs, how often, what AmpUp writes back, and how to fix common setup issues\">\u003cmeta data-mint-head name=\"application-name\" content=\"AmpUp Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/ampup/PolsO9XPzGsTBcC4/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/ampup/PolsO9XPzGsTBcC4/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/ampup/PolsO9XPzGsTBcC4/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/ampup/PolsO9XPzGsTBcC4/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/ampup/PolsO9XPzGsTBcC4/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/ampup/PolsO9XPzGsTBcC4/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/ampup/PolsO9XPzGsTBcC4/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/ampup/PolsO9XPzGsTBcC4/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/ampup/PolsO9XPzGsTBcC4/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Salesforce - AmpUp Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Connect Salesforce to AmpUp: what syncs, how often, what AmpUp writes back, and how to fix common setup issues\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"AmpUp Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.ampup.ai/integrations/salesforce\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://ampup.mintlify.site/_mintlify/api/og/v2?division=CRM+Platforms\u0026amp;title=Salesforce\u0026amp;description=Connect+Salesforce+to+AmpUp%3A+what+syncs%2C+how+often%2C+what+AmpUp+writes+back%2C+and+how+to+fix+common+setup+issues\u0026amp;theme=6eaba1cb34e5799c00195ba4\u0026amp;signature=0a05314d4973bf3ce11e4b8d401a44d3a73c381a0d3d925749783e9990746663\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Salesforce - AmpUp Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Connect Salesforce to AmpUp: what syncs, how often, what AmpUp writes back, and how to fix common setup issues\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://ampup.mintlify.site/_mintlify/api/og/v2?division=CRM+Platforms\u0026amp;title=Salesforce\u0026amp;description=Connect+Salesforce+to+AmpUp%3A+what+syncs%2C+how+often%2C+what+AmpUp+writes+back%2C+and+how+to+fix+common+setup+issues\u0026amp;theme=6eaba1cb34e5799c00195ba4\u0026amp;signature=0a05314d4973bf3ce11e4b8d401a44d3a73c381a0d3d925749783e9990746663\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/ampup/PolsO9XPzGsTBcC4/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"AmpUp Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2563EB\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.ampup.ai/integrations/salesforce\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/integrations/salesforce.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.ampup.ai/#organization\",\"name\":\"AmpUp Documentation\",\"url\":\"https://docs.ampup.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/ampup/CfEu0QltGPzGd3og/logo/light.svg?fit=max\u0026auto=format\u0026n=CfEu0QltGPzGd3og\u0026q=85\u0026s=4fe7377c117cd632347db0b16517ab76\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.ampup.ai#website\",\"name\":\"AmpUp Documentation\",\"url\":\"https://docs.ampup.ai\",\"publisher\":{\"@id\":\"https://docs.ampup.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.ampup.ai/integrations/salesforce#webpage\",\"url\":\"https://docs.ampup.ai/integrations/salesforce\",\"name\":\"Salesforce\",\"description\":\"Connect Salesforce to AmpUp: what syncs, how often, what AmpUp writes back, and how to fix common setup issues\",\"dateModified\":\"2026-09-22T23:17:47.651Z\",\"isPartOf\":{\"@id\":\"https://docs.ampup.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.ampup.ai/integrations/salesforce#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.ampup.ai/integrations/salesforce#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Integrations\",\"item\":\"https://docs.ampup.ai/integrations/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Salesforce\",\"item\":\"https://docs.ampup.ai/integrations/salesforce\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.ampup.ai/integrations/salesforce#article\",\"headline\":\"Salesforce\",\"name\":\"Salesforce\",\"description\":\"Connect Salesforce to AmpUp: what syncs, how often, what AmpUp writes back, and how to fix common setup issues\",\"url\":\"https://docs.ampup.ai/integrations/salesforce\",\"mainEntityOfPage\":{\"@id\":\"https://docs.ampup.ai/integrations/salesforce#webpage\"},\"dateModified\":\"2026-09-22T23:17:47.651Z\",\"publisher\":{\"@id\":\"https://docs.ampup.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.ampup.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"AmpUp Documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"AmpUp Documentation","nav":{"global":null,"anchors":[{"anchor":"Documentation","icon":"book-open","tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"Integrations","groups":[{"group":"Integrations","pages":[{"title":"Integrations Overview","description":"Connect your sales tools to AmpUp","href":"/integrations/overview"},{"group":"CRM Platforms","pages":[{"title":"Salesforce","icon":"cloud","href":"/integrations/salesforce"},{"title":"HubSpot","description":"Connect HubSpot CRM to sync your sales data with AmpUp","icon":"hubspot","href":"/integrations/hubspot"},{"title":"Microsoft Dynamics 365","icon":"microsoft","href":"/integrations/microsoft-dynamics"}]},{"group":"Conversation Intelligence","pages":[{"title":"Gong","icon":"waveform-lines","href":"/integrations/gong"},{"title":"Clari Copilot","icon":"headset","href":"/integrations/clari-copilot"},{"title":"Fathom","icon":"note-sticky","href":"/integrations/fathom"},{"title":"Fireflies","icon":"fire","href":"/integrations/fireflies"},{"title":"Salesloft","icon":"phone","href":"/integrations/salesloft"},{"title":"Avoma","icon":"microphone","href":"/integrations/avoma"},{"title":"Chorus (ZoomInfo)","icon":"circle-play","href":"/integrations/chorus"},{"title":"Zoom","icon":"video","href":"/integrations/zoom"},{"title":"Granola","icon":"note-sticky","href":"/integrations/granola"}]},{"group":"Meeting Platforms","pages":[{"title":"Microsoft Teams","icon":"microsoft","href":"/integrations/microsoft-teams"},{"title":"Google","icon":"google","href":"/integrations/google"}]},{"group":"AI Assistants","pages":[{"title":"AmpUp MCP Server","icon":"message-bot","href":"/integrations/claude-mcp"}]}]}]},{"tab":"Chat Widget","pages":[{"title":"Chat Widget","href":"/ampup-widget/installation"}]},{"tab":"Developer","pages":[{"title":"Developer","href":"/developer/overview"}]}]},{"anchor":"Contact Support","href":"mailto:support@ampup.ai","icon":"envelope"}]},"basePath":"","title":"Salesforce - AmpUp Documentation","buildId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","deploymentId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-5Xwp92K7.js","DynamicMarkdown-BoyYAA8K.js","zoom-image-lightbox-DkE6VzSN.js","lightbox-handle-r17bVUz3.js"]}