Skip Navigation
Show nav
Dev Center
  • Get Started
  • Documentation
  • Changelog
  • Search
  • Get Started
    • Node.js
    • Ruby on Rails
    • Ruby
    • Python
    • Java
    • PHP
    • Go
    • Scala
    • Clojure
    • .NET
  • Documentation
  • Changelog
  • More
    Additional Resources
    • Home
    • Elements
    • Products
    • Pricing
    • Careers
    • Help
    • Status
    • Events
    • Podcasts
    • Compliance Center
    Heroku Blog

    Heroku Blog

    Find out what's new with Heroku on our blog.

    Visit Blog
  • Log inorSign up
Hide categories

Categories

  • Heroku Architecture
    • Compute (Dynos)
      • Dyno Management
      • Dyno Concepts
      • Dyno Behavior
      • Dyno Reference
      • Dyno Troubleshooting
    • Stacks (operating system images)
    • Networking & DNS
    • Platform Policies
    • Platform Principles
  • Developer Tools
    • Command Line
    • Heroku VS Code Extension
  • Deployment
    • Deploying with Git
    • Deploying with Docker
    • Deployment Integrations
  • Continuous Delivery & Integration (Heroku Flow)
    • Continuous Integration
  • Language Support
    • Node.js
      • Working with Node.js
      • Node.js Behavior in Heroku
      • Troubleshooting Node.js Apps
    • Ruby
      • Rails Support
      • Working with Bundler
      • Working with Ruby
      • Ruby Behavior in Heroku
      • Troubleshooting Ruby Apps
    • Python
      • Working with Python
      • Background Jobs in Python
      • Python Behavior in Heroku
      • Working with Django
    • Java
      • Java Behavior in Heroku
      • Working with Java
      • Working with Maven
      • Working with Spring Boot
      • Troubleshooting Java Apps
    • PHP
      • PHP Behavior in Heroku
      • Working with PHP
    • Go
      • Go Dependency Management
    • Scala
    • Clojure
    • .NET
      • Working with .NET
  • Databases & Data Management
    • Heroku Postgres
      • Postgres Basics
      • Postgres Getting Started
      • Postgres Performance
      • Postgres Data Transfer & Preservation
      • Postgres Availability
      • Postgres Special Topics
      • Migrating to Heroku Postgres
    • Heroku Key-Value Store
    • Apache Kafka on Heroku
    • Other Data Stores
  • AI
    • Model Context Protocol
    • Vector Database
    • Heroku Inference
      • Inference Essentials
      • AI Models
      • Inference API
      • Quick Start Guides
    • Working with AI
  • Monitoring & Metrics
    • Logging
  • App Performance
  • Add-ons
    • All Add-ons
  • Collaboration
  • Security
    • App Security
    • Identities & Authentication
      • Single Sign-on (SSO)
    • Private Spaces
      • Infrastructure Networking
    • Compliance
  • Heroku Enterprise
    • Enterprise Accounts
    • Enterprise Teams
    • Heroku Connect (Salesforce sync)
      • Heroku Connect Administration
      • Heroku Connect Reference
      • Heroku Connect Troubleshooting
  • Patterns & Best Practices
  • Extending Heroku
    • Platform API
    • App Webhooks
    • Heroku Labs
    • Building Add-ons
      • Add-on Development Tasks
      • Add-on APIs
      • Add-on Guidelines & Requirements
    • Building CLI Plugins
    • Developing Buildpacks
    • Dev Center
  • Accounts & Billing
  • Troubleshooting & Support
  • Integrating with Salesforce
  • Heroku Enterprise
  • Heroku Connect (Salesforce sync)
  • Quick Start: Heroku Connect

Quick Start: Heroku Connect

English — 日本語に切り替える

Last updated December 04, 2024

Table of Contents

  • Prerequisites
  • Step 1: Create a Heroku App and Heroku Postgres Database
  • Step 2: Provision the Heroku Connect Add-on
  • Step 3: Provision a Logging Add-on
  • Step 4: Configure the Connection
  • Step 5: Set Up Mappings
  • (Optional) Step 6: Verify Setup
  • Next Steps

We recommend using our low-cost plans to complete this tutorial. Eligible students can apply for platform credits through our new Heroku for GitHub Students program.

This guide helps you set up the Heroku Connect add-on via the Heroku and Heroku Connect dashboards. See Heroku Connect for more info about this add-on.

See Setting Up Heroku Connect for setup recommendations and considerations.

 

See Quick Start: Heroku Connect CLI and Heroku Connect API if you prefer to set up with those tools instead of dashboards.

Prerequisites

  • A verified Heroku Account

Step 1: Create a Heroku App and Heroku Postgres Database

Heroku Connect requires Heroku Postgres for syncing data from Salesforce. Both Heroku Connect and Heroku Postgres are add-ons and must be attached to a Heroku app. You can attach add-ons to an empty app - deploying code isn’t required.

Adding a database to complete this tutorial counts towards your usage. Delete your database as soon as you’re done to control costs. Learn about our low-cost plans. Eligible students can apply for platform credits through our Heroku for GitHub Students program.

Create an empty app and attach Heroku Postgres to it:

  1. Open the Heroku Dashboard.
  2. Click New in the upper right and select Create new app.
  3. Provide an app name, choose a region for the app and click Create app.
  4. The app view loads when the app is created. Click the Resources tab.
  5. Search for Heroku Postgres in the Add-ons section.
  6. Select a plan and click the Submit Order Form button. Choose a -4 plan or larger for production use cases. See Heroku Connect for more info. For tutorial purposes only, you can choose the essential-0 plan to minimize costs.

Step 2: Provision the Heroku Connect Add-on

  1. Open the Heroku Dashboard.
  2. Click the app you want to attach Heroku Connect to.
  3. Click the Resources tab.
  4. Search for Heroku Connect in the Add-ons section.
  5. Select a plan and click the Submit Order Form button. See Available Plans for more info.

Heroku Connect appears in the Add-ons section of your Resources tab when provisioned.

Step 3: Provision a Logging Add-on

Logging add-ons are not yet compatible for Fir-generation apps. Skip this step and subscribe to our changelog to stay informed of when we add features.

Heroku Connect produces logs of its sync activity, which you can access from your log drain. Provision one of these logging add-ons for your application:

  1. Open the Heroku Dashboard.
  2. Click the app you want to attach Heroku Connect to.
  3. Click the Resources tab.
  4. Search for the add-on in the Add-ons section.
  5. Select a plan and click the Submit Order Form button.

Step 4: Configure the Connection

  1. Open the Heroku Connect Dashboard by clicking the add-on from the Heroku Dashboard Resources tab.
  2. Click the Setup Connection button in the dashboard.
  3. Choose a Heroku Postgres database that is attached to your application. If you have multiple databases attached to your application you can choose the one you want Heroku Connect to use. The database specified by the DATABASE_URL config var is selected by default.
  4. Choose the Postgres schema to be used for the tables created by Heroku Connect. The default is salesforce. You can choose to put your tables in an existing schema, including public, as long as no tables exist in the schema.
  5. Click Next to set up the database.
  6. Choose to authenticate to a production or sandbox Salesforce org. You can use a custom login domain.
  7. Select the Salesforce API version you want Heroku Connect to use. You can’t change the API version after configuring the connection. Recreate the connection to change the API version.
  8. Click the Authorize button and a browser opens for you to enter your Salesforce login credentials and authorize Heroku Connect. It’s recommended to use a dedicated integration user with View All Data permissions. See Heroku Connect for more info.

Step 5: Set Up Mappings

After you’ve authenticated to your Salesforce org, you can start mapping objects. To begin the process, click Create Mapping on the Overview tab of the Heroku Connect dashboard. See Managing Heroku Connect Mappings for full details.

(Optional) Step 6: Verify Setup

Check the following to verify that your data is syncing:

  1. Click the Mappings tab.
  2. The Status column indicates a mapping’s sync state. Check Mapping States Reference to ensure that all of your mappings are in a non-error state.

You can also verify that data is syncing by using the Explorer tab. You can view a side-by-side comparison of the data held in Salesforce and in the mapped database tables.

Next Steps

In this tutorial, you set up an empty Heroku app. To deploy code to this app, see these articles on deployments. Most users deploy their code with Git.

To connect to your Heroku Postgres database from your Heroku app, see Heroku Postgres.

To connect to Heroku Postgres from external connections, see External Connections (ingress) and Heroku Postgres on Private and Shield Spaces.

Keep reading

  • Heroku Connect (Salesforce sync)

Feedback

Log in to submit feedback.

Writing Data to Salesforce with Heroku Connect Quick Start: Heroku Connect API

Information & Support

  • Getting Started
  • Documentation
  • Changelog
  • Compliance Center
  • Training & Education
  • Blog
  • Support Channels
  • Status

Language Reference

  • Node.js
  • Ruby
  • Java
  • PHP
  • Python
  • Go
  • Scala
  • Clojure
  • .NET

Other Resources

  • Careers
  • Elements
  • Products
  • Pricing
  • RSS
    • Dev Center Articles
    • Dev Center Changelog
    • Heroku Blog
    • Heroku News Blog
    • Heroku Engineering Blog
  • Twitter
    • Dev Center Articles
    • Dev Center Changelog
    • Heroku
    • Heroku Status
  • Github
  • LinkedIn
  • © 2025 Salesforce, Inc. All rights reserved. Various trademarks held by their respective owners. Salesforce Tower, 415 Mission Street, 3rd Floor, San Francisco, CA 94105, United States
  • heroku.com
  • Legal
  • Terms of Service
  • Privacy Information
  • Responsible Disclosure
  • Trust
  • Contact
  • Cookie Preferences
  • Your Privacy Choices