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

Tools

Certification Tool

Learn more about the Certification tool in MinistryPlatform, including configuration settings, initial setup, and instructions to create a new certification.

The Certification tool integrates with MinistrySafe and allows you to track certifications for individuals who take part in ministry and volunteer opportunities.

  • This tool requires an integration with the third-party training provider, MinistrySafe.
  • With the Certification tool, you can:
    • Create certification records for contacts and participants.
    • View the current status of certification records for selected individuals.
    • Facilitate certification training for selected individuals to complete through MinistrySafe.
  • You can launch the Certification tool from an open record or from a selection of records on the Contacts, Participants or Members, or Participant Certification pages.
Note: To use this tool, you must have access through your security role. SPoCs can grant user access to this tool.

Certification Tool Configuration Settings Initial Setup

  • You must be a SPoC to do this.
A SPoC must set up a MinistrySafe webhook to send results back to MinistryPlatform. See the instructions in this MinistrySafe article: How to Add Webhooks for more information.
  1. Log into your MinistrySafe account and access their Developer Center here.
  2. In the Webhooks section, click Add Webhook.
  3. For Webhook URL, enter https://[your MP CloudApps Abbreviation].cloudapps.ministryplatform.cloud/tools-dev/api/certificationstatusapi/postministrysafestatus.
  4. For Webhook Username, enter a username of your choice and retain this value to add in your configuration settings.
  5. For Webhook Password, enter a password of your choice and retain this value to add in your configuration settings.
  6. For Webhook for, select Quizzes.
  7. Click Save.
    The Certification tool configuration settings screen. Under the Webhook For field, Quizzes has been selected.

Certification Tool Configuration Settings

This tool relies on several configuration settings:

Note: MinistrySafe is one word, so be sure to check for and eliminate any unnecessary spaces!
COMMON, CertificationsProvider
Your church's certifications provider. If NULL, certifications cannot be completed and you will see an error indicating that no provider is configured. We currently support the value "MinistrySafe" (case sensitive and no spaces).
COMMON, CertificationsApiAddress
The base address for the certifications API. For MinistrySafe, this should be safetysystem.abusepreventionsystems.com/api/v2/users.
COMMON, CertificationCallbackUsername
The username value you set when you created the MinistrySafe webhook.
COMMON, CertificationCallbackPassword
The password value you set when you created the MinistrySafe webhook.
COMMON, CertificationsPassingScore
The number that defines the minimum score for a certification training to be considered passing, if applicable.
TOOLS, CertificationsApiKey
The private API Key provided by your certifications provider, MinistrySafe, to interact with their API. For help, see this MinistrySafe article: How to Generate an API Key.

Create a New Certification

  1. Go to the Contacts, Participants or Members, or Participant Certification page.
  2. Click Tools, then click Certifications.
  3. Select the certification type you want to create.
  4. Under Selection Info, review the number of selected individuals in each category for this certification type.
    • Certifications Current/Completed: The number of people in the selection whose certification record has a status of Passed set to Yes.
    • Certifications In Process: The number of people in the selection whose certification record has a status of Passed set to N/A.
    • Certifications Expired/Missing: The number of people in the selection whose certification record has a status of Passed set to No OR do not currently have a record for this certification type.
  5. Optional: Enter any notes you want to include.
  6. Click Submit.
    • A record or request is created for each selected individual in the Expired/Missing category. If the person did not already have a participant record, one is created.
    • Requests are sent to MinistrySafe. For details, see this MinistrySafe article: Abuse Prevention Systems API Documentation.
  7. If needed, you can search for another individual to certify. Otherwise, you can close the tool.
Outside of MinistryPlatform:
  • MinistrySafe receives information from MinistryPlatform.
  • MinistrySafe sends an email with a certification request form to the selected people.
  • Recipients receive the email, begin training, and eventually complete training.
  • MinistrySafe sends updated certification information to MinistryPlatform.
  • Certification records and participant records are updated through the API to include the certification completed date and time, and Passed sets to Yes or No.
portal
MinistryPlatform
Tools

Last updated: November 24, 2025

Related Articles: