GFM Pro - logo

Set up the Facebook integration

Before you start

To use the Facebook integration your organization will need a Facebook page and a Facebook integration subscription. You'll also need to have domain masking turned on. If you need to set up any of these requirements, visit the following articles:

Enroll in PayPal Giving Fund

To use the Facebook integration, your nonprofit must be approved to accept donations through PayPal Giving Fund. Follow Facebook's instructions to enroll with PayPal Giving Fund. Once enrolled, your nonprofit will automatically be eligible to receive donations with a PayPal account.

If you already have a Facebook page that can accept donations, go ahead and skip to the section on creating a Facebook App.

Turn on fundraising and donation tools

Once approved for PayPal Giving Fund, you must turn on your fundraising and donation tools. To do so:

  1. Log in to Facebook
  2. Go to your nonprofit's Facebook page
  3. Select Nonprofit Manager
  4. In the menu, select Settings
  5. Select Fundraising
  6. Mark the checkboxes to allow people to create fundraisers and add donation buttons to their posts

Create a Facebook App

The next step is to create a Facebook app. A Facebook app allows your supporters to create fundraising pages under your organization's Facebook page. 

If you already have a Facebook app that allows people to sign in to your site with Facebook, you can go to the section on accessing your Facebook App ID and App Secret.

Create your app

To create a Facebook app:

  1. Log in to Facebook for Developers with your regular Facebook login credentials
  2. In the top-right corner, select Get Started

Note: If you already have a Facebook for Developers account, select My Apps instead. Then, select Create App on the next page.

  1. When the prompts ask what you need your app to do, select Other
  2. Select Business and then Continue
  3. Complete the form and select Create App

Create an app modal

App Display Name
We recommend your organization's name

App Contact Email
Add the email for whoever will manage your app

Business portfolio
Choose No Business portfolio selected

A Business Manager account helps Facebook verify your app, so we'll cover how to add one later in this article.

Edit your Basic Settings

Now that you created an app, you'll want to configure your settings so it's ready for use. To get started:

  1. In the menu, select App settings
  2. Select Basic

Basic settings button

Edit or confirm the following settings

You can use this information to confirm your App's Basic Settings are correct. Any fields not listed can be left blank for now.

Display name
This name appears in the Facebook login window when fundraisers create a Facebook fundraising page. We recommend using your organization's name.

Contact email
Facebook sends any updates regarding your app to this email. We recommend using the email address of whoever will manage your app.

Privacy Policy URL
Enter the link to your organization's privacy policy.

User data deletion
Enter GoFundMe Pro's Data Deletion Callback URL (https://preferences.gofundme.com/privacy)

Terms of Service URL
Enter the link to your organization's terms of service.

App icon
This icon appears in the Facebook login window when fundraisers create a Facebook fundraising page. For best quality, upload an image between 512 x 512 and 1024 x 1024 pixels.

Category
Select a category that best matches your organization. For most, we recommend Business and Pages.

Add a platform
Scroll to the bottom of the page and select + Add platform. Select Website and enter your organization's website. If you want to add a specific GoFundMe Pro campaign, add the full campaign URL rather than any short URLs.

Connect a Business Manager account

To use your app, you'll need to connect it to a Meta Business Manager account. A Meta Business Manager account helps Facebook verify your app. It also allows you to manage your pages and ads, give colleagues access to your apps, and receive page support from Facebook.

Start Business verification

  1. On the same page of App Settings - Basic and under Verifications and Business verification, select Start Verification

Business verification section in Meta

  1. Select Create new account
  2. Complete the Business Manager account form and select Create Account
  3. Select Verify later. We'll return to verify your business manager account in a moment.

Note: If you already have a Business Manager account, select it instead.

Connect your app

Keep your Facebook for Developers account in another browser tab and follow these steps.

  1. Go to your Business Manager account
  2. Select Accounts and then Apps
  3. Select the Add dropdown and Connect an App ID

Connect an App ID dropdown

  1. Go to the tab with your Facebook for Developers account and copy your App ID
  2. Go back to your Business Manager account and enter your App ID
  3. Select Add App

If your account created your app, your request will be approved immediately. Otherwise, you'll need to ask whoever manages your app to approve the request.

Request business verification

Next, you'll need to request Facebook to approve your Business Manager account. To do so:

  1. Go to your Business Manager account
  2. In the menu, select Security Center
  3. Under Verification, select Start Verification
  4. Enter your business details if prompted
  5. Confirm that you're part of your organization by email or phone

Your Business Verification status in your Facebook for Developers account will change to In Review. Facebook will notify you when you're verified.

Add app products

While you wait for business verification, you can add app products.

Add Facebook login

  1. Go to your Facebook for Developers account
  2. Select your app
  3. In the menu, select Products +
  4. Locate Facebook Login and select Set Up

screenshot of the facebook login setup button

  1. In the menu under Facebook Login, select Settings
  2. In the Valid OAuth Redirect URIs field, enter your domain-masked URL
  3. Toggle Login with the JavaScript SDK to Yes
  4. Under Allowed Domains for the JavaScript SDK, enter your domain-masked URL again. It'll appear as a blue tag.
  5. Select Save

screenshot of the facebook login OAuth redirect settings

You also need to make sure your public_profile is set to advanced access rather than standard access. To check and update, if needed:

  1. In the menu, select App Review
  2. Select Permissions and Features
  3. Search for public_profile
  4. If your Access Level is set to Standard Access, select Request Advanced Access

screenshot of the permissions and features page

Add Facebook Fundraisers

  1. Go to your Facebook for Developers account
  2. Select your app
  3. In the menu, select Products +
  4. Locate Fundraisers and select Set Up

screenshot of the set up fundraisers button

  1. Under App Review for Fundraiser API, select Add to Submission
  2. Select Edit Details
  3. Fill out the App Review form with the following
  • My organization is integrating with a tech provider
  • GoFundMe Pro
  • Your organization's Facebook page URL
  1. Select Submit for Review

Note: When you submit your app, Facebook will place it under review. The review process can take up to 3 weeks.

Once Facebook approves your app, a checkmark appears next to Fundraiser API.

screenshot of an approved fundraiser api with a green checkmark next to it.

Switch your app live

After Facebook's approval, you can switch your app live. To do so:

  1. At the top of the page, select the In development toggle
  2. Select Switch Mode

The toggle will update and show your app is live. You can always switch it back to development mode by selecting the toggle again.

Complete Facebook integration setup

Once you have an app, you can connect GoFundMe Pro and Facebook.

  1. Log in to Facebook for Developers
  2. In the menu, select App Settings and Basic
  3. Copy your App ID and App Secret

screenshot of the app id and app secret fields

Important: To keep your Facebook app secure, do not share your App ID and App Secret with anyone publicly.

Add your App ID and App Secret to GoFundMe Pro

  1. In your GoFundMe Pro account, select Apps & Extensions
  2. Select Facebook
  3. Enter your App ID and App Secret

Congrats! Your Facebook integration is now active. The next step is to turn it on in one of your campaigns.

Note: If you received an error when you attempted to enter your App ID and App Secret, this means Facebook has not granted your App access to the Fundraiser API yet. If Facebook hasn’t approved your app after three weeks, please reach out to our Care team.

Once activated, you can return to this page to turn on advanced reporting under Additional Configuration. Select Sync Data from Facebook to GoFundMe Pro and/or Sync Data from Instagram to GoFundMe Pro. Then select the GoFundMe Pro campaigns you'd like to associate the transactions with. Doing so will pull all Facebook and Instagram fundraising transaction data into your GoFundMe Pro reports.

Advanced reporting

With advanced reporting activated, GoFundMe Pro fundraising pages are kept in sync with Facebook fundraisers created from them. This means even transactions not processed by GoFundMe Pro, but ones that come through Facebook or Instagram fundraisers will still sync into GoFundMe Pro for reporting purposes. For more details on the difference with or without advanced reporting:

Without advanced reporting With advanced reporting

GoFundMe Pro only syncs donations from Facebook fundraisers that are tied to a GoFundMe Pro fundraising page

In GoFundMe Pro, these donations will be assigned to the relevant GoFundMe Pro fundraising pages

GoFundMe Pro syncs donations from Facebook fundraisers that were created directly on your Facebook nonprofit page

GoFundMe Pro syncs Instagram donations associated with your Facebook nonprofit page

In GoFundMe Pro, these donations will be assigned to the campaign you selected under “Additional Configuration” 

To turn on advanced reporting:

  1. Go to Apps & Integrations and Active Apps
  2. Select Meta
  3. Under Facebook integration, find GoFundMe Pro reporting
  4. Select the checkbox next to Sync data from Facebook to GoFundMe Pro
  5. Repeat for Instagram
  6. Choose which campaign you want to associate these transaction with in GoFundMe Pro

Note: The campaigns you choose need to be published for Facebook donations to sync into GoFundMe Pro.

Maintaining your integration

The Facebook app powering your Facebook integration requires regular maintenance. If it hasn't been properly maintained, Facebook will restrict the permissions of Apps or deactivate Apps altogether. This will prevent supporters from creating Facebook fundraisers via the Facebook integration, and, in some cases, it will also stop the sync between GoFundMe Pro and Facebook.

To maintain your app:

  • Monitor the contact email address you entered under Settings > Basic in your Facebook for Developers portal. Ideally, the email address should be monitored by someone who can log into the Facebook for Developers portal and manage your app.
  • Watch for notifications under Alerts in your Facebook for Developers portal. Before you launch a new campaign, ensure that all alerts have been attended to.
  • Complete the annual Data Use Checkups before the deadline set by Facebook. This shouldn’t take longer than 2 minutes.

Note: GoFundMe Pro is not considered a data processor or service provider of the data you receive from Meta.

Turn on the Facebook integration for a campaign

The Facebook integration is only available in peer-to-peer and registration with fundraising campaigns. To use the Facebook integration, you’ll need to turn it on at the campaign level. To turn on the Facebook integration:

  1. In your GoFundMe Pro' account, open the campaign you want to use
  2. Select Edit Campaign
  3. Select the Details tab
  4. In the menu, select Fundraising Settings

Screenshot of the fundraising settings in the campaign editor

  1. Switch Facebook Fundraiser status to Allow and save your changes

How it appears

Supporter Experience

Once the Facebook integration is turned on, supporters will have access to a Facebook tab in the editor for their GoFundMe Pro fundraising page. Now, supporters can duplicate their GoFundMe Pro fundraising page to Facebook. 

Learn how supporters create Facebook fundraising pages 

Reporting and Management

You can track donations with a Facebook integration report. Facebook fundraising activity will also display in your account’s activity feed (please note that comments sent from your home page activity feed will not be sent to supporters when the activity is from Facebook). Facebook activity will also display on campaign activity feeds.

Frequently asked questions

Does it matter when I “Allow Facebook Fundraising for fundraisers” on my campaign?

You can turn on or off the Facebook integration at any point in your peer-to-peer or registration with fundraising campaigns. Once you turn on the Facebook integration, fundraisers for that campaign will be able to create a Facebook fundraising page through GoFundMe Pro. For more details, view our article on creating a Facebook fundraising page

What happens if I turn the Facebook integration off and people have already created a Facebook fundraising page?

If supporters create a Facebook fundraising page through GoFundMe Pro, those pages will continue to collect donations, and the Facebook fundraising page will continue to exist. GoFundMe Pro will continue to record the donations as well. However, the option to create or access a Facebook fundraising page through GoFundMe Pro will no longer be available to the supporter.

How often do donations sync from Facebook to GoFundMe Pro?

Donations sync instantly between GoFundMe Pro and Facebook. However, Facebook only makes donor information available 48 hours after a donation. If a donation does not sync instantly, we re-sync it automatically within three days. In case a donation hasn’t synced after 72 hours, please contact the GoFundMe Pro Care team.

Not seeing what you need?

Contact us