--- title: Salesforce Integration Set Up description: How to set up an integration between Halda and Salesforce --- [Skip to content](https://info.halda.ai/knowledge/setting-up-a-salesforce-integration#main-content) [More support](https://info.halda.ai/knowledge/kb-tickets/new?hsLang=en) [![Halda Logo Black Tight-2.svg\]](https://info.halda.ai/hubfs/Halda%20Logo%20Black%20Tight-2.svg)](https://info.halda.io/knowledge?hsLang=en) - [AI Campaign Agent](https://info.halda.ai/knowledge/ai-campaign-agent) Show submenu for AI Campaign Agent - [AI Campaign Email](https://info.halda.ai/knowledge/ai-campaign-agent#ai-email-campaigns) - [Integrations](https://info.halda.ai/knowledge/ai-campaign-agent#integrations) - [AI Website Agent](https://info.halda.ai/knowledge/ai-website-agent#main-content) Show submenu for AI Website Agent - [AI Forms](https://info.halda.ai/knowledge/ai-website-agent#ai-forms) - [AI Hub](https://info.halda.ai/knowledge/ai-website-agent#ai-hub) - [AI Search](https://info.halda.ai/knowledge/ai-website-agent#ai-search) - [Integrations](https://info.halda.ai/knowledge/ai-website-agent#direct-integrations) - [Always On Recruiter Agent](https://info.halda.ai/knowledge/always-on-recruiter-agent#main-content) Show submenu for Always On Recruiter Agent - [AI Comeback Email](https://info.halda.ai/knowledge/always-on-recruiter-agent#ai-email) - [AI SMS and Phone](https://info.halda.ai/knowledge/always-on-recruiter-agent#ai-sms-and-phone) - [Integrations](https://info.halda.ai/knowledge/always-on-recruiter-agent#integrations) - [Analytics](https://info.halda.ai/knowledge/analytics#main-content) - [Settings](https://info.halda.ai/knowledge/settings#main-content) - [Student Records](https://info.halda.ai/knowledge/student-records) - [What's New](https://info.halda.ai/knowledge/whats-new) Open main navigation Close main navigation - [AI Campaign Agent](https://info.halda.ai/knowledge/ai-campaign-agent) Show submenu for AI Campaign Agent - [AI Campaign Email](https://info.halda.ai/knowledge/ai-campaign-agent#ai-email-campaigns) - [Integrations](https://info.halda.ai/knowledge/ai-campaign-agent#integrations) - [AI Website Agent](https://info.halda.ai/knowledge/ai-website-agent#main-content) Show submenu for AI Website Agent - [AI Forms](https://info.halda.ai/knowledge/ai-website-agent#ai-forms) - [AI Hub](https://info.halda.ai/knowledge/ai-website-agent#ai-hub) - [AI Search](https://info.halda.ai/knowledge/ai-website-agent#ai-search) - [Integrations](https://info.halda.ai/knowledge/ai-website-agent#direct-integrations) - [Always On Recruiter Agent](https://info.halda.ai/knowledge/always-on-recruiter-agent#main-content) Show submenu for Always On Recruiter Agent - [AI Comeback Email](https://info.halda.ai/knowledge/always-on-recruiter-agent#ai-email) - [AI SMS and Phone](https://info.halda.ai/knowledge/always-on-recruiter-agent#ai-sms-and-phone) - [Integrations](https://info.halda.ai/knowledge/always-on-recruiter-agent#integrations) - [Analytics](https://info.halda.ai/knowledge/analytics#main-content) - [Settings](https://info.halda.ai/knowledge/settings#main-content) - [Student Records](https://info.halda.ai/knowledge/student-records) - [What's New](https://info.halda.ai/knowledge/whats-new) - [More support](https://info.halda.ai/knowledge/kb-tickets/new) Welcome to the Halda Knowledge Base. - There are no suggestions because the search field is empty. 1. [Halda Knowledge Base](https://info.halda.ai/knowledge?hsLang=en) 2. [AI Website Agent](https://info.halda.ai/knowledge/ai-website-agent?hsLang=en) 3. [Direct Integrations](https://info.halda.ai/knowledge/ai-website-agent?hsLang=en#direct-integrations) May 19, 2026 # Salesforce Integration Set Up ## How to set up an integration between Halda and Salesforce The Halda + Salesforce integration pushes Halda data straight into your CRM so your team isn't copying records by hand. Setup happens in three phases, and you'll want about an hour from start to finish. **Heads up:** Salesforce retired Connected Apps and replaced them with **External Client Apps**. If you set up the integration before this change, your existing connection still works — but new setups follow the steps below. --- ### Phase 1 — Create an External Client App in Salesforce (~20 minutes) - Log in to Salesforce. - Click the gear icon in the upper-right corner and select **Setup**. - In the Quick Find box, type **App Manager** and select it. - Click **New External Client App** in the upper-right. *(This is the button that replaced "New Connected App.")* - Fill out the **Basic Information** section: - **External Client App Name:** `HaldaAPI` - **API Name:** auto-populates from the app name. - **Distribution State:** Local - **Contact Email:** your email address. - Expand the **API (Enable OAuth Settings)** section and check **Enable OAuth**. - In the **Callback URL** field, paste the URL below — replacing `[accountId]` with your Halda account ID:    https://app.heyhalda.com/accounts/\[accountId\]/settings/integrations/salesforce/callback **Finding your account ID:** Log in to Halda and go to your account home page. The URL looks like `https://app.heyhalda.com/accounts/{accountId}` — the part after `/accounts/` is your account ID. - In **Selected OAuth Scopes**, move the following from Available to Selected: - Manage user data via APIs (`api`) - Perform requests at any time (`refresh_token`, `offline_access`) - Under **Flow Enablement**, make sure **Enable Authorization Code and Credentials Flow** is checked. - Under **Security**, **uncheck** *Require Proof Key for Code Exchange (PKCE) Extension for Supported Authorization Flows*. - Check **Require Secret for Web Server Flow** and **Require Secret for Refresh Token Flow** (both should be on by default). - Click **Create** at the bottom. - After creation, reopen the app from the **External Client App Manager**, go to the **Policies** tab, and click **Edit**. Set **Refresh Token Policy** to *Refresh token is valid until revoked* and save. **Wait 10–20 minutes** before moving on. Salesforce needs time to propagate the new app before it can authenticate. Don't start Phase 2 until that window passes — you'll hit auth errors if you do. --- ### Phase 2 — Connect Halda to Your Salesforce Instance (~15 minutes) - Back in the **External Client App Manager**, find your HaldaAPI app and open it. - Expand the **OAuth Settings** section and click **Consumer Key and Secret**. Salesforce will ask you to verify your identity with an email code before showing the values. - Copy the **Consumer Key** and **Consumer Secret** somewhere safe — you'll paste them into Halda next. > **Note on permissions:** If you see an "Insufficient Privileges" error trying to view the consumer details, your Salesforce admin needs to grant your profile the *View all External Client Apps, views their settings, and edit policies* permission. - Log in to Halda. - Click the menu in the top right. - Click **Integrations**. - Find the Salesforce integration and click **Connect**. - Paste in the Consumer Key and Consumer Secret, then enter credentials for the integration user when prompted. --- ### Phase 3 — Map objects and fields (30–45 minutes) Once Phases 1 and 2 are done, Halda's team will work with you to map your Salesforce objects and fields. This is where we make sure every piece of data Halda collects lands in the right place on the right record before anything starts flowing. If you need any assistance with setting up your Salesforce Integration, reach out to your Partner Success Consultant or Implementation Specialist.  - [Getting Started](https://info.halda.ai/knowledge/getting-started?hsLang=en#main-content) - [Start Here](https://info.halda.ai/knowledge/getting-started?hsLang=en#start-here) - [Halda Best Practices](https://info.halda.ai/knowledge/getting-started?hsLang=en#halda-best-practices) - [AI Campaign Agent](https://info.halda.ai/knowledge/ai-campaign-agent?hsLang=en#main-content) - [AI Landing Pages](https://info.halda.ai/knowledge/ai-campaign-agent?hsLang=en#ai-landing-pages) - [AI Email Campaign Creation](https://info.halda.ai/knowledge/ai-campaign-agent?hsLang=en#ai-email-campaign-creation) - [AI Email Campaign Record Ingestion and Suppression](https://info.halda.ai/knowledge/ai-campaign-agent?hsLang=en#ai-email-campaign-record-ingestion-and-suppression) - [AI Email Campaign Management](https://info.halda.ai/knowledge/ai-campaign-agent?hsLang=en#ai-email-campaign-management) - [AI Email Campaign Integrations](https://info.halda.ai/knowledge/ai-campaign-agent?hsLang=en#ai-email-campaign-integrations) - [Reporting](https://info.halda.ai/knowledge/ai-campaign-agent?hsLang=en#reporting) - [AI Website Agent](https://info.halda.ai/knowledge/ai-website-agent?hsLang=en#main-content) - [AI Forms](https://info.halda.ai/knowledge/ai-website-agent?hsLang=en#ai-forms) - [AI Hub](https://info.halda.ai/knowledge/ai-website-agent?hsLang=en#ai-hub) - [AI Search](https://info.halda.ai/knowledge/ai-website-agent?hsLang=en#ai-search) - [Direct Integrations](https://info.halda.ai/knowledge/ai-website-agent?hsLang=en#direct-integrations) - [Other Integration Options](https://info.halda.ai/knowledge/ai-website-agent?hsLang=en#other-integration-options) - [Always On Recruiter Agent](https://info.halda.ai/knowledge/always-on-recruiter-agent?hsLang=en#main-content) - [AI Comeback Email](https://info.halda.ai/knowledge/always-on-recruiter-agent?hsLang=en#ai-comeback-email) - [AI SMS and Phone](https://info.halda.ai/knowledge/always-on-recruiter-agent?hsLang=en#ai-sms-and-phone) - [Integrations](https://info.halda.ai/knowledge/always-on-recruiter-agent?hsLang=en#integrations) - [Student Records](https://info.halda.ai/knowledge/student-records?hsLang=en) - [Analytics](https://info.halda.ai/knowledge/analytics?hsLang=en#main-content) - [Conversion Analytics](https://info.halda.ai/knowledge/analytics?hsLang=en#conversion-analytics) - [Campaign Tracking](https://info.halda.ai/knowledge/analytics?hsLang=en#campaign-tracking) - [AI SEO](https://info.halda.ai/knowledge/analytics?hsLang=en#ai-seo) - [Integrations](https://info.halda.ai/knowledge/analytics?hsLang=en#integrations) - [Settings](https://info.halda.ai/knowledge/settings?hsLang=en#main-content) - [AI Knowledge Base](https://info.halda.ai/knowledge/settings?hsLang=en#ai-knowledge-base) - [Notifications](https://info.halda.ai/knowledge/settings?hsLang=en#notifications) - [Account Settings](https://info.halda.ai/knowledge/settings?hsLang=en#account-settings) - [Script Install](https://info.halda.ai/knowledge/settings?hsLang=en#script-install) - [Fields](https://info.halda.ai/knowledge/settings?hsLang=en#fields) - [Additional Information](https://info.halda.ai/knowledge/additional-information?hsLang=en) - [Troubleshooting](https://info.halda.ai/knowledge/troubleshooting?hsLang=en#main-content) - [AI Campaign Agent](https://info.halda.ai/knowledge/troubleshooting?hsLang=en#ai-campaign-agent) - [What's New](https://info.halda.ai/knowledge/whats-new?hsLang=en) - [Privacy Policy](https://www.halda.ai/privacy) - [Terms & Conditions](https://www.halda.ai/terms-conditions) - [About Halda](https://www.halda.ai/platform) - [App Login](https://app.heyhalda.com/) [![Halda Logo](https://info.halda.ai/hubfs/Halda%20Logo%20Black%20Tight-2.svg "Halda Logo")](http://Halda.io) [halda.ai](http://halda.ai)  Copyright © 2026, Halda