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.

Questions? Email us at support@goodchange.app.

Updated on: 25/05/2026