Skip to main content

SendGrid Receipe

  • Official Website: https://sendgrid.com/
  • Icon Support: no
  • Message Format: Text
  • Message Limit: 32768 Characters per message

Account Setup#

Creating an account with SendGrid is free of charge and can be done through their main page.

Once you have an account and access to your dashboard. You will need to ensure you've correctly authenticated your domains with them; this is done in the Sender Authentication section of your dashboard. You get here by clicking on Settings > Sender Authentication from your dashboard.

The last thing you need is to generate an API Key with at least the Mail Send permission. This can also be done through your dashboard in the API Keys section of your dashboard. You can get here by clicking on Settings > API Keys

Receipe#

Valid receipes are as follows:

  • {schema}://{apikey}:{from_email}
  • {schema}://{apikey}:{from_email}/{to_email}
  • {schema}://{apikey}:{from_email}/{to_email1}/{to_email2}/{to_email3}

Template support is also supported as well, You just need to specify the UUID assigned to it as part of the URL:

  • {schema}://{apikey}:{from_email}/{to_email}?template={template_uuid}

If you want to take advantage of the dynamic_template_data variables, just create arguments prefixed with a plus (+); for example:

  • sendgrid://{apikey}:{from_email}/{to_email}?template={template_uuid}&+{sub1}=value&+{sub2}=value2

Parameter Breakdown#

VariableRequiredDescription
apikeyYesThe API Key you generated from within your SendGrid dashboard.
from_emailYesThis is the email address will identify the email's origin (the From address). This address must contain a domain that was previously authenticated with your SendGrid account (See Domain Authentication).
to_emailNoThis is the email address will identify the email's destination (the To address). If one isn't specified then the from_email is used instead.
templateNoYou may optionally specify the UUID of a previously generated SendGrid dynamic template to base the email on.
ccNoThe Carbon Copy (CC:) portion of the email. This is entirely optional. It should be noted that SendGrid immediately rejects emails where the cc contains an email address that exists in the to or the bcc list. To avoid having issues, Magic Receipe automatically eliminates these duplicates silently if detected.
bccNoThe Blind Carbon Copy (BCC:) portion of the email. This is entirely optional. It should be noted that SendGrid immediately rejects emails where the bcc contains an email address that exists in the to or the cc list. To avoid having issues, Magic Receipe automatically eliminates these duplicates silently if detected. If an identical email is detected in both the CC and the BCC list, the BCC list will maintain the email and it will drop from the CC list automatically.

Dynamic Template Data#

Templates allow you to define {{variables}} within them that can be substituted on the fly once the email is sent. You can identify and set these variables using Magic Receipe by simply sticking a plus (+) in front of any parameter you specify on your URL string.

Consider the following template: d-e624763c71314ea2a1fae38d7fa64a4a

This is a test email about {{what}}.
You can take a mapped variable on a SendGrid template
and easily swap it with whatever you want using {{app}}.

In the above example, we defined the following variables: what and app.

An Magic Receipe URL might look like:
sendgrid://myapikey:noreply@example.com?template=d-e624763c71314ea2a1fae38d7fa64a4a&+what=templates&+app=Magic Receipe

The above URL would create the following:

This is a test email about templates.
You can take a mapped variable on a SendGrid template
and easily swap it with whatever you want using Magic Receipe.