home

MinistryPlatform

RealmRealm AccountingMinistryPlatformeGivingPDSACSConnectShepherdGrowth MethodHeadMasterRefresh WebsitesTrust CenterGo MethodMissionInsite
RealmRealm AccountingMinistryPlatformeGivingPDSACSConnectShepherdGrowth MethodHeadMasterRefresh WebsitesTrust CenterGo MethodMissionInsite

What would you like to know more about?

Show Contents

Show Page Sections

thumbnailMinistryPlatform

SendGrid

Platform Integration for SendGrid

Adding the SendGrid integration to the Platform improves performance and provides near-instantaneous information feedback about the status of the messages you send. So, the next time a ministry leader wonders how their newsletter was received, you'll be able to 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. Keep reading for those steps!

Configure MinistryPlatform

Add a GUID to one field, and the Platform is ready to go!

  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've added your GUID to the SMTP Server Callback Secret field, you'll need to 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'll need to 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, and Spam Reports.
  6. Under Deliverability Data, select Dropped, Bounced, and Delivered.
  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

MinistryPlatform
portal

Last updated: May 17, 2024