SendGrid Integration

SendGrid integration setup instructions for Gleam

Gleam allows you to integrate your campaigns with SendGrid, this includes sending users from Competitions, Rewards or Capture.

Integrating SendGrid

You can enable the SendGrid integration on the Pro plan & above. Simply navigate to Settings > Integrations then turn on SendGrid.

Connect your SendGrid API Key to Gleam.io

You will need an API key, which you can create under Settings > API Keys. When creating your API key you'll need to ensure that the below permissions are enabled for the key:

  • Mail Send > Mail Send - Full Access
  • Marketing > Marketing - Full Access
Sendgrid API Key permissions required

Custom Field Sync Support

We support the syncing of Custom Fields for SendGrid through our Custom Field Sync feature, you can set this up via the Custom Field Mapping button when setting up the integration.

Sending Emails to SendGrid

Once you've activated your SendGrid integration within Gleam you will need to include a Subscribe action in your campaign.

This subscribe action can contain the name of the list you want to send subscribers to, please be aware that this list must exist within SendGrid already.

Subscribe to a Newsletter action with SendGrid integration connected

Testing Your SendGrid Integration

In order to test if emails successfully send to SendGrid you need to do the following:

  • Have a competition created with a Subscribe action
  • Ensure that this action is linked to an existing tag in SendGrid
  • Enter the action manually from your competition dashboard
  • The action will become invalidated (since we automatically invalidate admin actions)
  • Go to the Actions tab for that competition, then make your action valid
  • It should appear in SendGrid within a few minutes