home

MinistryPlatform

RealmMinistryPlatformPDSACSAccountingGivingConnectShepherdGrowth MethodGo MethodMissionInsiteGatherHeadMaster ChildcareTrust Center
RealmMinistryPlatformPDSACSAccountingGivingConnectShepherdGrowth MethodGo MethodMissionInsiteGatherHeadMaster ChildcareTrust Center

What would you like to know more about?

Show Contents

Show Page Sections

thumbnailMinistryPlatform

External Login Authentication

Facebook

This section covers what you need to know to configure your instance of MinistryPlatform so your members can log in through their Facebook accounts.

You can configure MinistryPlatform so your members can create an account or log in to the Platform using their Facebook account. To set up a Facebook external login, you need access to three places:
  • MinistryPlatform, with rights to the Identity Providers page.
  • Facebook's Developer Site, with rights to create a new app.
  • Your server.
    Important: If you do not have access to your server, coordinate this set up with someone who does.
    Tip: It is helpful to be logged in to the Platform and Facebook's Developer site at the same time.

Create an Identity Provider in the Platform

  1. In the navigation menu, click Administration > Identity Providers.
  2. Click New Identity Provider.
  3. Add a display name.
  4. For Provider Type, select Facebook.
  5. Add a Client ID.
    Note: You'll replace this during the set up process, so any value is fine.
  6. Click Save.
  7. Copy the Identity Unique ID that is generated when you save. You'll need this later.
    Tip: You'll need this value with all uppercase letters. Check out convertcase.net for a handy shortcut.

Create & Configure the Facebook App

  1. Log in to Facebook's Developers site.
  2. Create an app.
    1. Click Create App.
    2. Click Create a Connected Experience.
    3. Provide the necessary information.
      Tip: Use an administrative email. For example, support@[yourchurch].com.
    4. Click Create App.
  3. Configure the app.
    1. Go to Dashboard > Add Products to Your App > Facebook login.
    2. Click Set Up.
    3. Select WWW.
    4. Provide your website URL. Be sure to include "widgets" to in your URL (for example, "https://[yourdomain]/widgets").
    5. Click Save.
    6. Skip options 2-5.
  4. Go to Products > Facebook Login > Settings and make the following selections:
    1. Set Client OAuth Login to Yes.
    2. Set Web OAuth Login to Yes.
    3. Set Enforce HTTPS to Yes.
    4. Set Force Web OAuth Reauthentication to No.
    5. Set Embed Browser OAuth Login to No.
    6. Set Use Strict Mode for Redirect URLs to Yes.
    7. Set Login from Devices to No.
  5. Add your Value OAuth Redirect URI.
    1. Add the Identity Provider Unique ID that was created when you set up the Facebook Identity Provider in the Platform.
      https://[YourDomain]/ministryplatformapi/oauth/callback/[IdentityProviderUniqueID]
      Remember: You'll need the Identity Provider Unique ID to contain all uppercase characters.
    2. Save your changes.

Add OAuth Data

  1. In the Dashboard, go to Settings > Basics and copy the App ID.
  2. Paste the App ID into the Client ID field on the Facebook Identity Provider record in the Platform.
  3. Back in the Facebook Developer site, go to Settings > Basic and copy the App Secret.
  4. Paste the App Secret into the Client Secret field on the Facebook Identity Provider record in the Platform.
  5. While in the Platform, set Is Public to Yes.
  6. Save the updated Facebook Identity Provider record.
  7. Back in the Facebook Developer site, go to Settings > Basic and add any necessary contact information.
  8. Click Save Changes.

Recycle the App Pool & Test

  • MinistryPlatform only register identity provider changes with a full application pool reset.
  • If you do not have access to your server, coordinate this set up with someone who does.
    Tip: Open a window in Incognito mode and go to the Platform. You should see the option to log in using Facebook.
  • To confirm you can link your Facebook account to the Platform, go to the Edit User Account screen, select Social Logins and then select Facebook.
    Note: After you confirm the Facebook login works, return to the Facebook Developer's app dashboard and toggle In Development to Off. Then, you must provide some additional information.
portal
MinistryPlatform
Platform

Last updated: November 24, 2025