home

MinistryPlatform

RealmRealm AccountingMinistryPlatformGivingPDSACSConnectShepherdGrowth MethodHeadMasterRefresh WebsitesTrust CenterGo MethodMissionInsite
RealmRealm AccountingMinistryPlatformGivingPDSACSConnectShepherdGrowth MethodHeadMasterRefresh WebsitesTrust CenterGo MethodMissionInsite

What would you like to know more about?

Show Contents

Show Page Sections

thumbnailMinistryPlatform

SendGrid

Platform Integration for SendGrid

Add the SendGrid integration to the Platform to improve performance and provide near-instant information feedback about the status of the messages you send. So, the next time a ministry leader wonders how recipients received their newsletter, you can tell them with impressive speed and accuracy.

Ready to get started? You'll need to configure the Platform, generate an event webhook, then configure SendGrid.

Configure MinistryPlatform

Prepare MinistryPlatform to use SendGrid.

  1. Generate a GUID.
    Tip: We recommend using a GUID Generator to generate a random value.
  2. Go to System Setup > Domains/Accounts.
  3. Edit your domain record.
  4. For SMTP Server Callback Secret, add the GUID you generated.
  5. Click Save.

Generate an Event Webhook

Use the formula to generate a webhook.

Once you add your GUID to the SMTP Server Callback Secret field, you must generate an event webhook to use when you configure your SendGrid account.

  1. Copy this URL, and paste it into a document.
    https://[your domain]/ministryplatformapi/callback/sendgrid/[SMTP Server Callback Secret]
  2. Replace "[your domain]" with your Domain name, which is the part of your Platform URL before "/mp".
  3. Replace "[SMTP Server Callback Secret]" with the GUID you added in the Platform.

Configure SendGrid

Add your webhook to SendGrid, and your integration will be up and running in no time!

Important: If you already have an event webhook configured in SendGrid, you must replace it with the newly configured webhook.
  1. Log in to SendGrid.
  2. Go to Settings > Mail Settings.
  3. By the Event Webhook setting, click the pencil icon to edit it.
  4. For Post URL, add your newly created event webhook.
  5. Under Engagement Data, select Opened, Clicked, Unsubscribed, Spam Reports, and Group Unsubscribes.
    Note: There is an option to send information about Group Resubscribes, but MinistryPlatform doesn't currently show that. As of December 2024, we are working on an enhancement so you will be able to see this in the Platform!
  6. Under Deliverability Data, select Dropped, Bounced, and Delivered.
    Note: There are options to send information about Processed and Deferred deliveries. However, MinistryPlatform doesn't currently provide statuses that correspond to these actions. That said, it doesn't hurt to select those options in case we decide to show those in the Platform at a later time.
  7. Set Event Webhook Status to Enabled.
  8. Click Save.

Here's what your event webhook setup might look like in SendGrid:

Example of what your event webhook setup might look like in SendGrid

portal
MinistryPlatform

Last updated: November 26, 2024