Search documentation...



Power internal tools, in-app experiences, and more

Set up in MongoDB

You'll need to allowlist Hightouch's IP addresses to allow our systems to contact your MongoDB instance. Reference our docs to determine which IPs you need to allowlist.

Best practices

Create a user in MongoDB specifically for Hightouch and only allow that user to access the tables you want the Hightouch integration to access. Do not use the 'root' user.

Connect to MongoDB

When creating a MongoDB destination, you can choose the host, port, username, password, and database, or provide the full URI connection string. For more information, go to the official connection guide.

Locating the connection string in MongoDB

The connection string is available in multiple locations, but a quick way to find it is to click on the 'connect' button next to the name of your cluster:

From the options available, select 'Connect your application':

Follow the instructions for changing the password and database name in the string. Copy the string by clicking the 'copy' icon:

Back in Hightouch, in the MongoDB setup configuration, you can paste your saved connection string into the field provided:

Mappings and identifiers

Hightouch requires identifying one field as the document main identifier. Usually is the _id field, which is autogenerated by MongoDB if not provided, but you can choose any other field. Be aware that you might need an index on that field to speed up the sync.

For mappings, you could send every column as a field in the document, or choose mappings that allow you to filter and translate to the field names you need for your documents.

Compatible Versions

The minimum supported MongoDB version is 4.0. Earlier versions might work fine but are not officially supported.

    Need help?

    Our team is relentlessly focused on your success. We're ready to jump on a call to help unblock you.

    • Connection issues with your data warehouse?
    • Confusing API responses from destination systems?
    • Unsupported destination objects or modes?
    • Help with complex SQL queries?

    Feature Requests?

    If you see something that's missing from our app, let us know and we'll work with you to build it!

    We want to hear your suggestions for new sources, destinations, and other features that would help you activate your data.

On this page

Set up in MongoDBBest practicesConnect to MongoDBLocating the connection string in MongoDBMappings and identifiersCompatible Versions

Was this page helpful?