> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://goodchange.crisp.help/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Connecting NationBuilder

GoodChange integrates with NationBuilder to push donor and donation data directly into your political CRM. Once connected, new donations flow through automatically.

***Connecting your NationBuilder account to GoodChange / SmartChange***
  
  Connecting NationBuilder lets every donation made through your fundraising forms automatically sync
  into NB as a signup + donation, attributed to a tracking code per fundraising form.
  
  **What you'll need before you start**

  - **NationBuilder admin access** to your nation (specifically, the ability to manage Apps and Permission
   sets)
  - **5 minutes**

  **Step 1 — Ask us to share the app with your nation**
  
  Email us at support@goodchange.app (or support@smartchange.app for SmartChange) with your **NB nation **
  **slug** — that's the subdomain part of your NB admin URL (e.g., for myCampaign.nationbuilder.com/admin,
   the slug is myCampaign).

  We'll add your nation to our app's allowed list. You'll get a confirmation back from us, usually
  within a business day.

  **Step 2 — Grant API access to our integration user**

  While you wait for our confirmation, set this up on your NB nation:
  
  1. In your NB admin, go to **Settings → Permission sets**
  2. Either pick an existing permission set with **API access enabled** OR create a new one (check the
  "Make API requests" permission)
  3. Assign that permission set to contact@levelwins.com
  
  This grants our integration the API access it needs without giving us any broader admin rights than
  necessary.

  **Step 3 — Connect from your GoodChange / SmartChange dashboard**

  Once we've confirmed Step 1:

  1. Log into your GoodChange (or SmartChange) campaign dashboard
  2. Go to **Integrations** → find NationBuilder → click **Connect**
  3. You'll be redirected to NB → click **Authorize**
  4. You'll be sent back to GoodChange/SmartChange. The integration is now active.

  **What happens next**

  From this point on, every donation through any of your fundraising forms will:
  
  - Create the donor as a signup in NB (or match them to an existing signup by email)
  - Record the donation in NB with all the donor details
  - Tag the donation with a tracking code matching the fundraiser they came through — so you can see
  in NB exactly which form drove which dollars
  
  The first donation through each new fundraiser will create a tracking code in NB on the fly, named
  after the fundraiser. Subsequent donations through that same fundraiser reuse the same code.

  **Troubleshooting**

  **"This app is not registered for use by this nation"** — Step 1 hasn't been completed yet. Reach out to
   support so we can add your nation slug.

  **Donations are syncing to NationBuilder but with the wrong donor info** — Double-check the donor's billing details
   on the GoodChange side. NB pulls whatever was entered on the donation form.

  **Donations stopped syncing after about 24 hours** — Our token may have failed to refresh. Email support
   — usually a quick fix on our end without you needing to re-authorize.

**What gets synced:**
* Donors are matched by email or created as new people records
* Donations are logged with tracking codes for source attribution
* Custom fields map to NationBuilder tags where supported

**Tracking codes:** GoodChange automatically creates tracking codes on new donations so you can run reports in NationBuilder by source.


![](https://storage.crisp.chat/users/helpdesk/website/-/8/f/e/3/8fe32a7262b6a800/screenshot-2026-04-14-at-12133_1danot6.png =500x231)


Questions? Email us at support@goodchange.app.