Skip to content

Introduction

NOMA Sync Architecture

What is NOMA Sync?

NOMA Sync Engine is the central hub that connects Givebutter (donations, events, P2P), Square (merchandise, e-commerce), and Mailchimp (newsletter) to Little Green Light — your main donor database.

One system. One database. Zero manual data entry.

Start here: Dashboard

Log in at the Dashboard to monitor syncs, fix errors, and configure how campaigns map to LGL.

Open Dashboard →

Dashboard at a Glance

PageWhat you do
SyncsSee all sync activity, filter by source/status, open a row for details, resolve errors, resync
MappingsSet how Givebutter and Square campaigns map to LGL funds
Square OrdersView orders, enrich customer data, resync to LGL
Mailchimp SettingsMap lists and tag rules for newsletter sync
SettingsLGL environment (production/sandbox), alert recipients, defaults
TeamsManage users and permissions (Super Admin only)

Dashboard vs Worker

  • Dashboard (https://noma.21adsmedia.io/) — Where you log in and work. This is the only URL you need.
  • Worker — The backend that receives data from Givebutter, Square, and Mailchimp. You never open it. Your developer configures webhooks and API keys using a separate webhook URL in each platform (not the Dashboard URL).

The Three Integrations

What Gets Synced

SourceWhatWhereWhen
GivebutterDonations, event tickets, P2P fundraisersLGL constituents + giftsReal-time
SquareOnline store ordersLGL constituents + giftsReal-time
MailchimpNewsletter signups, unsubscribesLGL constituents + tagsReal-time

Events on the site: Event campaigns from Givebutter sync to the NOMA website; staff can also create recurring (weekly/monthly) events in WordPress. See Events.

Quick Start

Who Uses NOMA Sync?

  • NOMA Staff (Viewers): Monitor donations, view sync logs, check campaign totals
  • NOMA Admins: Configure mappings, resolve sync errors, manage settings
  • Super Admin: Full access, invite users, manage integrations

How it works (high level)

When someone donates, buys, or subscribes:

  1. Event arrives → The system receives it from Givebutter, Square, or Mailchimp
  2. Data is processed → Campaign is mapped to an LGL fund; constituent is matched or created
  3. LGL is updated → Gift (or tag update) is recorded
  4. Dashboard updates → The sync appears in Syncs with status success or failed

Everything in Little Green Light within 5–10 seconds.

Glossary

TermMeaning
DashboardThe web app where you log in to monitor syncs and configure mappings.
LGLLittle Green Light — NOMA’s main donor database.
ConstituentA donor or contact record in LGL (name, email, etc.).
FundA campaign or designation in LGL (e.g. “Unrestricted,” “Event 2025”).
WebhookAn automatic notification from Givebutter, Square, or Mailchimp when something happens (donation, order, unsubscribe). The system receives it and syncs to LGL.
SyncOne run of the system moving data (e.g. one donation = one row in Syncs).

Need Help?