Skip to content
ERP ⇄ Database

Brightpearl to MongoDB integration — real-time, two-way sync

Keep Brightpearl and MongoDB in sync without custom scripts. Cut weeks of integration work, eliminate silent data drift, and give your team a single, reliable source of truth.

  • SOC 2 and 6 other compliance frameworks
  • POC with real engineers in minutes

Adopted by fast-scaling companies moving mission-critical data in real time

Case study
Migrated from MuleSoft
Case study
Migrated from Celigo
Migrated from Heroku Connect
Migrated from Matillion
Case study
Migrated from Fivetran
Case study
Migrated from Celigo
Why teams connect Brightpearl and MongoDB

Give your engineers Brightpearl's data in MongoDB: read it with normal queries, write back through the sync, and skip the ERP API entirely.

ERP data sits behind interfaces built for the ERP's own modules, not for your internal systems. Teams that need those records, for reporting services, internal tools, or automations, end up writing integration code against a strict API and maintaining it through every upgrade.

Stacksync mirrors Goods-out notes, Invoices and payments, Custom fields, Products from Brightpearl into MongoDB and keeps both sides consistent in real time. Whatever Brightpearl is the system of record for, whether financials, operations, people, or procurement, those records become rows your code can query, and changes written in MongoDB sync back into Brightpearl with its validations respected.

Common use cases

  • 01 Keep a MongoDB-backed product catalog aligned with an ERP's item master in both directions.
  • 02 Consolidate documents from multiple clusters or tenants into a single warehouse-facing store.
  • 03 Land order and margin data in a warehouse for retail performance reporting.
  • 04 Sync Brightpearl sales orders and fulfillment status with a CRM so sales and support see order state without switching tools.

Common sync patterns

Controlled write-back

Choose exactly which tables and fields may flow from MongoDB back into Brightpearl, keeping the ERP authoritative.

Read ERP records with a query

Records from Brightpearl live in MongoDB as ordinary tables or collections, joinable with the rest of your data.

Internal tools and automations without API code

Scripts and services read and write the synced tables; Stacksync handles the Brightpearl interface, limits, and retries.

What you can sync between Brightpearl and MongoDB

Representative objects on each side — any object or custom field can map to any target. Schemas are auto-detected; types are converted between the two systems.

Brightpearl objects MongoDB objects How this pairing syncs
Contacts Customers and suppliers in one contact model, matched to CRM records by email or reference. Collections The table-like sync unit; each collection maps to a table or object in the paired system. Contacts is specific to Brightpearl and Collections to MongoDB — each maps to any object or custom field on the other side.
Inventory and warehouses On-hand and allocated stock by warehouse, read for availability publishing. Documents BSON records created, updated, and deleted during syncs, keyed by _id. Inventory and warehouses is specific to Brightpearl and Documents to MongoDB — each maps to any object or custom field on the other side.
Goods-out notes Fulfillment documents that carry picking and shipping status back to order sources. Embedded documents and arrays Nested structures that syncs flatten or map to related records in relational targets. Goods-out notes is specific to Brightpearl and Embedded documents and arrays to MongoDB — each maps to any object or custom field on the other side.
Invoices and payments Financial documents synced to accounting platforms for reconciliation. Indexes Keep lookups by sync key fast on large collections. Invoices and payments is specific to Brightpearl and Indexes to MongoDB — each maps to any object or custom field on the other side.
Custom fields Per-object custom attributes included in field mappings. Views Read-only aggregation-defined sources for filtered sync datasets. Custom fields is specific to Brightpearl and Views to MongoDB — each maps to any object or custom field on the other side.
Products SKU records with variants and price lists, synced with e-commerce and ERP catalogs. Change streams The oplog-backed event feed that powers real-time change capture. Products is specific to Brightpearl and Change streams to MongoDB — each maps to any object or custom field on the other side.

How changes propagate between Brightpearl and MongoDB

Each direction of the sync is driven by what the source system can signal and what the destination accepts — detection, delivery, and expected latency below.

Brightpearl MongoDB Sub-second propagation

DetectionBrightpearl notifies Stacksync of record changes through webhook events. Webhooks for object created/updated events, with resource search polling as a fallback.

DeliveryEach detected change is applied to MongoDB as a row-level write, with types converted between the two schemas.

MongoDB Brightpearl Sub-second propagation

DetectionChanges in MongoDB are captured at the source via change data capture — no polling loop against its API. MongoDB oplog and change streams (requires the database to run as a replica set — even single-node).

DeliveryEach detected change is written to Brightpearl through its API, with automatic retries and rate-limit backoff.

Rate-limit considerations

  • Brightpearl: Requests are throttled per account under Brightpearl's API usage policies; bulk operations should use batch endpoints.
What ships with Brightpearl ⇄ MongoDB

Connect Brightpearl and MongoDB for flexible, real-time data sync.

Real-time sync, workflow automation, event queues, EDI, and monitoring, for every Brightpearl–MongoDB connection.

Real-time

Two-way sync

Changes in Brightpearl or MongoDB instantly reflect in both systems. No stale data, no manual imports.

No-code + pro-code

Workflow automation

Trigger automated workflows whenever Brightpearl or MongoDB data changes, update records, fire webhooks, or kick off sequences without brittle API scripts.

At scale

Event queues

Handle millions of events per minute without losing a single Brightpearl or MongoDB record.

Observability

Monitoring

Track your Brightpearl ⇄ MongoDB sync health, view errors, and replay failed events in one click.

Trading partners

EDI

Transform legacy EDI complexity into simple database interactions between Brightpearl and MongoDB.

How the Brightpearl and MongoDB connectors work

Brightpearl

Integration surface
REST API, organized into services (order, product, contact, warehouse, accounting)
Authentication
OAuth 2.0 (authorization code grant) for current apps; legacy private and public apps authenticate with app reference and account token headers
Change detection
Webhooks for object created/updated events, with resource search polling as a fallback
Capabilities
read · write · webhooks
Rate limits
Requests are throttled per account under Brightpearl's API usage policies; bulk operations should use batch endpoints

MongoDB

Integration surface
MongoDB wire protocol via official drivers; Atlas additionally offers an administration REST API for cluster management
Authentication
Database credentials (username/password) or TLS/SSL X.509 certificate (.pem upload), entered individually or via a MongoDB connection string (SRV or standard); Stacksync IP allowlisting required
Change detection
MongoDB oplog and change streams (requires the database to run as a replica set — even single-node); Stacksync leverages these built-in tools to track changes in real time
Capabilities
read · write · CDC
MongoDB setup guide
How it works

How to connect Brightpearl to MongoDB — three steps, no code

Configure and sync within minutes, no code. Whether you sync 50k or 100M+ records, Stacksync handles the queues, infra, and plumbing. Integrations are non-invasive and need zero setup on your systems.

  1. 01

    Connect your apps

    Authenticate Brightpearl and MongoDB with each platform's native method — OAuth, API keys, or service accounts — plus secure options like SSH tunneling, IP whitelisting, and VPC peering.

    • OAuth 2.0
    • SSH tunnel
    • VPC peering
    Brightpearl connected
    MongoDB connected
    OAuth 2.0
    SSH tunnel
    SSL certificate
    VPC peering
  2. 02

    Choose tables

    Pick the Brightpearl and MongoDB objects to sync — Stacksync auto-detects both schemas, including custom fields where the platform exposes them. Sync to existing tables, or let Stacksync create new ones with ideal data types.

    • Standard objects
    • Custom objects
    • Auto-schema
    objects · Brightpearl ⇄ MongoDB
    Customers 12,480
    Sales Orders 8,213
    Invoices 5,902
    Items 1,344
  3. 03

    Map fields

    Fields map automatically even when names and types differ. Stacksync handles transformation and type casting for you, zero configuration required.

    • Auto-map
    • Type casting
    • Transforms
    Brightpearl MongoDB
    Company company_name text
    Email email text
    Amount amount numeric
    Created created_at timestamp
FAQ

Brightpearl and MongoDB integration FAQ

SECURITY

Security teams trust Stacksync

As a data company, we understand the importance of keeping your data secure. Stacksync is built with security best practices to keep your data safe at every layer, and is DPF-certified for US, EU, UK and CH data transfers.

SOC 2 Type II
ISO 27001
HIPAA BAA
GDPR
CCPA
DPF US-EU-UK-CH
→ SECURITY WITH BENEFITS

SSO & SCIM

Let your users access Stacksync from your centralized user management systems. Works with Okta, Azure, Google SSO and more.

Alerts

Immediately get alerted about record syncing issues over email, Slack, PagerDuty and WhatsApp. Resolve issues from a centralized dashboard with retry and revert options.

Secure connection options

Securely connects to your systems with:

Related integrations

Every pair below is a real-time, two-way sync. Search all 541 integrations available for Brightpearl and MongoDB.

Popular · 7 of 541
Coworkers laughing in front of a laptop in a casual office setting

Your last integration took months.
Your next one takes a prompt.