# FunnelKeeper + MongoDB

> Map documents in your collections to funnel stages with dot-notation paths.

FunnelKeeper reads MongoDB collections through a single connection string and turns documents into funnel events. Nested fields are addressed with dot notation, so you map what you already store.

- **Category:** Conversions & revenue
- **Access:** read-only
- **Sync:** Hourly. A new connection backfills in stages — 30 days, then a year, then the whole table (as deep as your plan's history window) — then reads a rolling 7-day window.
- **On demand:** yes — Sync now is available

## What FunnelKeeper reads from MongoDB

- Mapped funnel events from the collections you nominate
- Identity and attribution values at nested field paths (for example user.email, utm.source)
- Transaction amounts as integer cents in their source currency

## What it never does

- No writes, no index creation, no aggregation pipelines left behind
- The connection string is stored encrypted and never displayed again

## How to connect MongoDB

| Surface | How |
| --- | --- |
| Dashboard | Integrations → MongoDB → Connect database, then Event maps |
| MCP | connect_mongo, then set_mongo_event_maps |
| API | POST /products/{slug}/connections/mongo |

## FAQ

### Does MongoDB Atlas work?

Yes. Create a read-only database user, allow the FunnelKeeper egress address in Atlas network access, and paste the SRV connection string. It is stored as one encrypted blob.

### What if the field I need is nested three levels deep?

Use the dot-notation path — for example checkout.payment.amount_cents. Event maps address identity, attribution and value fields the same way.

## Related

- [MySQL](https://funnelkeeper.com/integrations/mysql/) — Turn rows in your existing MySQL database into a joined customer journey.
- [Postgres](https://funnelkeeper.com/integrations/postgres/) — The same row-to-funnel mapping as MySQL, schema-aware for Postgres.
- [First-party event tracking](https://funnelkeeper.com/integrations/event-tracking/) — No database to connect? Send funnel events straight from your site or backend.

Full catalogue: https://funnelkeeper.com/integrations/ · Machine index: https://funnelkeeper.com/llms.txt