MongoDB

MongoDB has no views, so you pick the fields in Rowsend and no setup script runs. You bring a read-only user, and Rowsend saves its whole connection string on your computer, encrypted with your system keychain.

Atlas

1. In Atlas, open Database Access and click Add New Database User.

2. Pick Password and set a username and password. Under Built-in Role, choose Only read any database.

3. In Network Access, add your current IP address.

4. From your cluster’s Connect, then Drivers, copy the connection string.

5. Fill in the password, and add your database name after the host:

   mongodb+srv://rowsend:your-password@cluster0.abcde.mongodb.net/yourdb?retryWrites=true

Any other MongoDB

Create a user with the read role on your database, and put the database name after the host:

mongodb://rowsend:your-password@db.example.com:27017/yourdb

The server must have access control turned on. Rowsend refuses a server that lets anyone in.

Connect

1. In Rowsend, open Contacts, click Connect a database, choose Atlas or Other MongoDB, paste the connection string and click Continue.
2. Pick the collection your users are in, then its fields: Email and Last changed are required. For Last changed, pick a timestamp that changes whenever the document does, such as updatedAt.
3. Tick any other fields to add. Nested fields work, written with dots, such as profile.plan.
4. Click Test and connect.

Rowsend checks the user’s permissions first, and refuses a user that can change data.

What to know

• Rowsend lists fields from a sample of 100 documents per collection, up to three levels deep. A field missing from that sample won’t be listed.
• Documents with no email are skipped.
• Each sync reads documents whose Last changed time is at or after the previous sync’s. A change that doesn’t update that field won’t reach Rowsend until something else does.
• To change fields later, open Project settings → Database and click Edit fields. Rowsend resyncs every contact. No disconnect is needed.