Skip to content

Notify_sendgrid

Chris Caron edited this page Sep 2, 2024 · 3 revisions

SendGrid Notifications

  • Source: https://sendgrid.com/
  • Icon Support: no
  • Attachment Support: Yes
  • 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

Syntax

Valid syntaxes 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

Variable Required Description
apikey Yes The API Key you generated from within your SendGrid dashboard.
from_email Yes This 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_email No This 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.
template No You may optionally specify the UUID of a previously generated SendGrid dynamic template to base the email on.
cc No The 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, Apprise automatically eliminates these duplicates silently if detected.
bcc No The 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, Apprise 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 Apprise 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 Apprise URL might look like:
sendgrid://myapikey:[email protected]?template=d-e624763c71314ea2a1fae38d7fa64a4a&+what=templates&+app=Apprise

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 Apprise.

Example

Send a sendgrid notification:

# Assuming our {apikey} is abcd123-xyz
# Assuming our Authenticated Domain is example.com, we might want to
#  set our {from_email} to [email protected]
# Assuming our {to_email} is [email protected]
apprise -vv -t "Test Message Title" -b "Test Message Body" \
   sendgrid:///abcd123-xyz:[email protected]/[email protected]
Clone this wiki locally