Apps (Filters)

Following are the apps that can be specified in the filters section of the X-SMTPAPI header. All filters and setting names must be lowercase.

For more information on the utility of these apps, please check out the Apps section.

Filter: bcc

Sends a BCC copy of the email created in this transaction to the address specified.

1
2
3
4
5
6
7
8
9
10

{
  "filters" : {
    "bcc" : {
      "settings" : {
        "enable" : 1,
        "email" : "you@example.com"
      }
    }
  }
}

Filter: bypass_list_management

Some emails are too important to do normal list management checks, such as password resets or critical alerts. Enabling this filter will bypass the normal unsubscribe / bounce / spam report checks and queue the e-mail for delivery.

1
2
3
4
5
6
7
8
9

{
  "filters" : {
    "bypass_list_management" : {
      "settings" : {
        "enable" : 1
      }
    }
  }
}

Filter: clicktrack

Rewrites links in e-mail text and html bodies to go through our webservers, allowing for tracking when a link is clicked on.

Example X-SMTPAPI Header Value

1
2
3
4
5
6
7
8
9

{
  "filters" : {
    "clicktrack" : {
      "settings" : {
        "enable" : 1
      }
    }
  }
}

Filter: dkim

Allows you to specify the domain to use to sign messages with DKIM certification. This domain should match the domain in the From address of your e-mail. For more info, check out these details on DKIM.

Example X-SMTPAPI Header Value

1
2
3
4
5
6
7
8
9
10

{
  "filters" : {
    "dkim" : {
      "settings" : {
        "domain" : "example.com",
        "use_from" : false
      }
    }
  }
}

Filter: domainkeys

Allows you to specify the domain to use to sign messages with Domain Keys. This domain should match the domain in the From address of your e-mail. For more info, check out these details on Domain Keys.

Example X-SMTPAPI Header Value

1
2
3
4
5
6
7
8
9
10
11

{
  "filters" : {
    "domainkeys" : {
      "settings" : {
        "enable" : 1,
        "domain" : "example.com",
        "sender" : 1
      }
    }
  }
}

Filter: footer

Inserts a footer at the bottom of the text and HTML bodies.

Example X-SMTPAPI Header Value

1
2
3
4
5
6
7
8
9
10
11

{
  "filters" : {
    "footer" : {
      "settings" : {
        "enable" : 1,
        "text/html" : "<p>Thanks,<br />The SendGrid Team<p>",
        "text/plain" : "Thanks,\n The SendGrid Team"
      }
    }
  }
}

Filter: forwardspam

Allows for a copy of spam reports to be forwarded to an email address.

1
2
3
4
5
6
7
8
9
10

{
  "filters" : {
    "forwardspam" : {
      "settings" : {
        "enable" : 1,
        "email" : "you@example.com"
      }
    }
  }
}

Filter: ganalytics

Re-writes links to integrate with Google Analytics.

Example X-SMTPAPI Header Value

1
2
3
4
5
6
7
8
9
10
11
12
13

{
  "filters" : {
    "ganalytics" : {
      "settings" : {
        "enable" : 1,
        "utm_source" : "Transactional Email",
        "utm_medium" : "email",
        "utm_content" : "Reset Your Password",
        "utm_campaign" : "Redesigned Transactional Messaging"
      }
    }
  }
}

Filter: gravatar

Inserts an img tag at the bottom of the html section of an e-mail to display the gravatar associated with the mail sender.

Example X-SMTPAPI Header Value

1
2
3
4
5
6
7
8
9

{
  "filters" : {
    "gravatar" : {
      "settings" : {
      "enable" : 1
      }
    }
  }
}

Filter: opentrack

Inserts an <img> tag at the bottom of the html section of an e-mail which will be used to track if an e-mail is opened.

Example X-SMTPAPI Header Value

1
2
3
4
5
6
7
8
9

{
  "filters" : {
    "opentrack" : {
      "settings" : {
        "enable" : 1
      }
    }
  }
}

Filter: spamcheck

Tests message with SpamAssassin to determine if it is spam, and drop it if it is.

Example X-SMTPAPI Header Value

1
2
3
4
5
6
7
8
9
10
11

{
  "filters" : {
    "spamcheck" : {
      "settings" : {
        "enable" : 1,
        "maxscore" : 3.5,
        "url" : "http://example.com/compliance"
      }
    }
  }
}

Filter: subscriptiontrack

Inserts a subscription management link at the bottom of the text and html bodies or insert the link anywhere in the email.

If you wish to append an unsubscription link, use the text/html and text/plain paremeters. However, if you wish to have the link replace a tag (such as [unsubscribe]), use the replace parameter.

Example X-SMTPAPI Header Value

1
2
3
4
5
6
7
8
9
10
11

{
    "filters": {
        "subscriptiontrack": {
            "settings": {
                "text/html": "If you would like to unsubscribe and stop receiving these emails <% click here %>.",
                "text/plain": "If you would like to unsubscribe and stop receiving these emails click here: <% %>.",
                "enable": 1
            }
        }
    }
}

Filter: templates

Uses a template created with the Template Engine when sending an email. More information on usage of the Template Engine with the SMTP API may be found in the Template Engine API Reference.

Example X-SMTPAPI Header Value

1
2
3
4
5
6
7
8
9
10

{
  "filters": {
    "templates": {
      "settings": {
        "enable": 1,
        "template_id": "5997fcf6-2b9f-484d-acd5-7e9a99f0dc1f"
      }
    }
  }
}

Filter: template

Wraps a template around your email content. Useful for sending out marketing email and other nicely formatted messages.

Example X-SMTPAPI Header Value

1
2
3
4
5
6
7
8
9
10

{
  "filters" : {
    "template" : {
      "settings" : {
        "enable" : 1,
        "text/html" : "<html><head></head><body bgcolor='pink'><div style='width:200px' bgcolor='#FFF'><% body %></div></body></html>"
      }
    }
  }
}

Was this helpful? Yes No Feedback