From 73914a228e80531a800e16ba35bb6d885d90ac04 Mon Sep 17 00:00:00 2001 From: Matt Bernier Date: Wed, 8 Apr 2015 09:02:41 -0600 Subject: [PATCH 01/17] Group Suppressions can trigger Webhook events --- .../Suppression_Tracking/suppressions_vs_unsubscribes.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/User_Guide/Email_Deliverability/Suppression_Tracking/suppressions_vs_unsubscribes.md b/source/User_Guide/Email_Deliverability/Suppression_Tracking/suppressions_vs_unsubscribes.md index 890133aa57..6f48f1b24d 100644 --- a/source/User_Guide/Email_Deliverability/Suppression_Tracking/suppressions_vs_unsubscribes.md +++ b/source/User_Guide/Email_Deliverability/Suppression_Tracking/suppressions_vs_unsubscribes.md @@ -17,5 +17,5 @@ When using ASM, a recipient clicking an unsubscribe link can choose which groups You can manage your global suppressions via [Email Reports > Unsubscribes](https://sendgrid.com/unsubscribes) in the SendGrid portal. {% info %} -Group Suppressions do not currently trigger [Event Webhook]({{root_url}}/API_Reference/Webhooks/event.html) events. -{% endinfo %} \ No newline at end of file +Group Suppressions will trigger [Event Webhook]({{root_url}}/API_Reference/Webhooks/event.html) events. +{% endinfo %} From 21be34d6540d2a92c844e3ee97f896d857635ba7 Mon Sep 17 00:00:00 2001 From: Matt Bernier Date: Wed, 8 Apr 2015 09:02:59 -0600 Subject: [PATCH 02/17] Group Suppressions can trigger Webhook events pt 2 --- .../Subscription_Tracking/suppressions_vs_unsubscribes.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/User_Guide/Email_Deliverability/Subscription_Tracking/suppressions_vs_unsubscribes.md b/source/User_Guide/Email_Deliverability/Subscription_Tracking/suppressions_vs_unsubscribes.md index c1d59452aa..d74d3bc7ec 100644 --- a/source/User_Guide/Email_Deliverability/Subscription_Tracking/suppressions_vs_unsubscribes.md +++ b/source/User_Guide/Email_Deliverability/Subscription_Tracking/suppressions_vs_unsubscribes.md @@ -17,5 +17,5 @@ When using ASM, a recipient clicking an unsubscribe link can choose which groups You can manage your global unsubscribes via [Email Reports > Unsubscribes](https://sendgrid.com/unsubscribes) in the SendGrid portal. {% info %} -Group Unsubscribes do not currently trigger [Event Webhook]({{root_url}}/API_Reference/Webhooks/event.html) events. -{% endinfo %} \ No newline at end of file +Group Unsubscribes will trigger [Event Webhook]({{root_url}}/API_Reference/Webhooks/event.html) events. +{% endinfo %} From bd0cf1ba480ea6a0ca557e0408f28f1d8dd8e6b9 Mon Sep 17 00:00:00 2001 From: Matt Bernier Date: Sat, 11 Apr 2015 13:30:29 -0600 Subject: [PATCH 03/17] Too many See Alsos --- source/User_Guide/Transactional_Email/unsubscribes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/User_Guide/Transactional_Email/unsubscribes.md b/source/User_Guide/Transactional_Email/unsubscribes.md index 935e26ed27..e58458ff45 100644 --- a/source/User_Guide/Transactional_Email/unsubscribes.md +++ b/source/User_Guide/Transactional_Email/unsubscribes.md @@ -12,5 +12,5 @@ If you are sending email through SendGrid and have the [Subscription Tracking ap The [Subscription Tracking app]({{root_url}}/User_Guide/Apps/subscription_tracking.html) also has a number of options for customization, such as a replacement tag that allows you to place the unsubscribe text somewhere in the body of the email, the ability to reword the unsubscribe message, and the ability to add a custom landing page. -See Also: See Also: [Marketing Email Unsubscribes]({{root_url}}/User_Guide/Marketing_Emails/unsubscribes.html) +See Also: [Marketing Email Unsubscribes]({{root_url}}/User_Guide/Marketing_Emails/unsubscribes.html) From 455ff1105389676f8cb0b8d84bb6527c93998dd6 Mon Sep 17 00:00:00 2001 From: Matt Bernier Date: Sat, 11 Apr 2015 15:09:15 -0600 Subject: [PATCH 04/17] Adding subuser info block --- .../API_Reference/Web_API_v3/Template_Engine/templates.md | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/source/API_Reference/Web_API_v3/Template_Engine/templates.md b/source/API_Reference/Web_API_v3/Template_Engine/templates.md index 082b2d9100..43b52d202e 100644 --- a/source/API_Reference/Web_API_v3/Template_Engine/templates.md +++ b/source/API_Reference/Web_API_v3/Template_Engine/templates.md @@ -7,13 +7,16 @@ navigation: show: true --- -The Template Engine API lets you programmatically create and manage -templates for your transactional email. +The Template Engine API lets you programmatically create and manage templates for your transactional email. {% info %} Each user can have up to 300 templates. {% endinfo %} +{% info %} +Templates created in Template Engine are account and subuser specific. Templates created on a parent account will not be accessible from the subuser accounts. +{% endinfo %} + * * * * * {% anchor h2 %} From c6b95a33fa6d6387e07f0374b215ee6c8754686b Mon Sep 17 00:00:00 2001 From: Matt Bernier Date: Sat, 11 Apr 2015 16:39:43 -0600 Subject: [PATCH 05/17] Added portal reputation information --- source/Glossary/sender_reputation.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/source/Glossary/sender_reputation.md b/source/Glossary/sender_reputation.md index d11da62baa..aa4aa7f877 100644 --- a/source/Glossary/sender_reputation.md +++ b/source/Glossary/sender_reputation.md @@ -20,3 +20,14 @@ The Reputation score is a score about your email deliverability reputation score - Consistent mailing volume To achieve the highest reputation possible, we recommend that you have an opt-in process to the email addresses you send to, don’t purchase email lists, and continue to keep your lists clean. + +{% anchor h2 %} +How is my reputation calculated? +{% endanchor %} + +* Low bounce rates +* Very few spam complaints +* The ratio of invalid emails sent out +* Consistent mailing volume + +To achieve the highest reputation possible, we recommend that you have an industry standard opt-in process, don't rent or buy email lists and always keep your lists clean. From 43a762abb52489f3ff8565e7ff55e4799685a467 Mon Sep 17 00:00:00 2001 From: Matt Bernier Date: Mon, 13 Apr 2015 15:49:58 -0600 Subject: [PATCH 06/17] moved warning here, rather than Apps page --- source/API_Reference/SMTP_API/apps.html | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/source/API_Reference/SMTP_API/apps.html b/source/API_Reference/SMTP_API/apps.html index 4c7c8b1609..c44d7993e7 100644 --- a/source/API_Reference/SMTP_API/apps.html +++ b/source/API_Reference/SMTP_API/apps.html @@ -69,6 +69,10 @@ Filter: bypass_list_management {% endanchor %} +{% warning %} +This app is very powerful, and can only be used on a per-message basis. Use with extreme caution. +{% endwarning %} +

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.

From 3851d59e1f37a985c9a6dc986fc46e368a836de1 Mon Sep 17 00:00:00 2001 From: Matt Bernier Date: Mon, 13 Apr 2015 16:13:31 -0600 Subject: [PATCH 07/17] This page doesn't belong here --- .../User_Guide/Apps/bypass_list_management.md | 42 ------------------- 1 file changed, 42 deletions(-) delete mode 100644 source/User_Guide/Apps/bypass_list_management.md diff --git a/source/User_Guide/Apps/bypass_list_management.md b/source/User_Guide/Apps/bypass_list_management.md deleted file mode 100644 index c0dbe0c900..0000000000 --- a/source/User_Guide/Apps/bypass_list_management.md +++ /dev/null @@ -1,42 +0,0 @@ ---- -layout: page -weight: 0 -title: Bypass List Management -navigation: - show: true ---- - -{% warning %} -This app is very powerful, and can only be used on a per-message basis. Use with extreme caution. -{% endwarning %} - -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. - -{% anchor h2 %} -API Settings -{% endanchor %} - -
- - - - - - - - - - - - - - -
App NameSetting FieldDescription
bypass_list_managementenable - 0 to disable -
- 1 to enable -
- -Settings may be changed through: - -- [SMTP API]({{root_url}}/API_Reference/SMTP_API/apps.html#bypass_list_management) (on a per message basis) From 33253a1a2095edc2b3b67021bd8b8544707620dc Mon Sep 17 00:00:00 2001 From: mbernier Date: Mon, 13 Apr 2015 16:34:56 -0600 Subject: [PATCH 08/17] removed link to blm page --- source/User_Guide/Apps/index.html | 1 - 1 file changed, 1 deletion(-) diff --git a/source/User_Guide/Apps/index.html b/source/User_Guide/Apps/index.html index f6a6f5c1cf..4ac2fc3097 100644 --- a/source/User_Guide/Apps/index.html +++ b/source/User_Guide/Apps/index.html @@ -11,7 +11,6 @@
  • Address Whitelisting*
  • BCC*
    • -
  • Bypass List Management*
  • Click Tracking
  • Domain Keys
  • DKIM*
    • From 73961e6f8ad6074226696955989b8782169b5e31 Mon Sep 17 00:00:00 2001 From: Anthony Santa-Iglesia Date: Tue, 14 Apr 2015 14:10:19 -0700 Subject: [PATCH 09/17] Update filter_settings.md typo in the *POST Data* box --- source/API_Reference/Web_API/filter_settings.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/API_Reference/Web_API/filter_settings.md b/source/API_Reference/Web_API/filter_settings.md index 2837cf5da1..8f26a7a939 100644 --- a/source/API_Reference/Web_API/filter_settings.md +++ b/source/API_Reference/Web_API/filter_settings.md @@ -316,7 +316,7 @@ SPAM Filter Checker {% endparameters %} -{% apiexample spamcheck POST https://api.sendgrid.com/api/filter.setup api_user=your_sendgrid_username&api_key=your_sendgrid_password&name=eventnotify&max_score=1.2&url=https://www.example.com/spamcheck.php %} +{% apiexample spamcheck POST https://api.sendgrid.com/api/filter.setup api_user=your_sendgrid_username&api_key=your_sendgrid_password&name=spamcheck&max_score=1.2&url=https://www.example.com/spamcheck.php %} {% response json %} { "message": "success" From 4433a8979ededc0d727616388ccc960aeac82098 Mon Sep 17 00:00:00 2001 From: Jacob Date: Wed, 15 Apr 2015 10:38:27 -0600 Subject: [PATCH 10/17] Add bounces POST warning add a warning box explaining that unique_args sometimes get lost. --- source/API_Reference/SMTP_API/unique_arguments.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/source/API_Reference/SMTP_API/unique_arguments.md b/source/API_Reference/SMTP_API/unique_arguments.md index 2190ff2e3e..ec5b4f7fd5 100644 --- a/source/API_Reference/SMTP_API/unique_arguments.md +++ b/source/API_Reference/SMTP_API/unique_arguments.md @@ -42,6 +42,8 @@ These arguments can then be seen in posts from the [SendGrid Event Webhook]({{ro } {% endcodeblock %} +{% warning %} There are a few cases where unique_args cannot be attached to the Event. Specifically Bounces that are returned via the Return-Path. Please keep this in mind when developing unique_args POST handling. {% endwarning %} + Unique Arguments will also be shown in the [Email Activity tab](https://sendgrid.com/logs/index) of your account. To apply different unique arguments to individual emails, you may use [substitution tags]({{root_url}}/API_Reference/SMTP_API/substitution_tags.html). An example of this would look like: From 284dd27ea4b612b52a05d50659f8962df60e5c76 Mon Sep 17 00:00:00 2001 From: Anthony Santa-Iglesia Date: Thu, 16 Apr 2015 14:32:31 -0700 Subject: [PATCH 11/17] Update advanced.md looks like the ***"esp & esps"*** params are no longer being used, rather ***"mailbox_providers"***. Not sure if the wording is now going to be ***"mailbox_providers"***, as ESP can cause confusion. --- source/API_Reference/Web_API_v3/Stats/advanced.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/source/API_Reference/Web_API_v3/Stats/advanced.md b/source/API_Reference/Web_API_v3/Stats/advanced.md index 6cc08ed374..c0ba4330b1 100644 --- a/source/API_Reference/Web_API_v3/Stats/advanced.md +++ b/source/API_Reference/Web_API_v3/Stats/advanced.md @@ -247,10 +247,10 @@ Gets email statistics by email service provider (ESP). {% parameter start_date Yes 'Date formatted as YYYY-MM-DD' 'The starting date of the statistics to retrieve' %} {% parameter end_date No 'Date formatted as YYYY-MM-DD' 'The end date of the statistics to retrieve. Defaults to today.' %} {% parameter aggregated_by No 'Must be day|week|month' 'How to group the statistics' %} - {% parameter esps No 'Array of strings' 'The ESPs to get statistics for, up to 10' %} + {% parameter mailbox_providers No 'Array of strings' 'The ESPs to get statistics for, up to 10' %} {% endparameters %} -{% apiv3example get GET https://api.sendgrid.com/v3/esp/stats?start_date=2015-01-01&end_date=2015-01-02 %} +{% apiv3example get GET https://api.sendgrid.com/v3/mailbox_providers/stats?start_date=2015-01-01&end_date=2015-01-02 %} {% v3response %} HTTP/1.1 200 [ @@ -363,4 +363,4 @@ HTTP/1.1 200 } ] {% endv3response %} -{% endapiv3example %} \ No newline at end of file +{% endapiv3example %} From 4fdc241e3234022f82c9c8cc593e807ce3006c41 Mon Sep 17 00:00:00 2001 From: Matt Bernier Date: Sat, 18 Apr 2015 16:14:47 -0600 Subject: [PATCH 12/17] Changed display title --- source/User_Guide/SendGrid_for_Mobile/suppression.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/User_Guide/SendGrid_for_Mobile/suppression.md b/source/User_Guide/SendGrid_for_Mobile/suppression.md index d0672fc47b..ea6f876157 100644 --- a/source/User_Guide/SendGrid_for_Mobile/suppression.md +++ b/source/User_Guide/SendGrid_for_Mobile/suppression.md @@ -1,7 +1,7 @@ --- seo: title: SendGrid for iPhone and iPad Suppression Lists -title: SendGrid for iPhone and iPad Suppression Lists +title: Suppression Lists weight: 600 layout: page navigation: @@ -24,4 +24,4 @@ Depending on the list you're viewing, you can tap on an address to get more info If you're viewing the Unsubscribe list, you can hit the "+" button to manually add an address to the list. -Finally, if you want to search for a specific address, pull downwards on the list and type an address in the search field. \ No newline at end of file +Finally, if you want to search for a specific address, pull downwards on the list and type an address in the search field. From 9aaa30ccd2027742aa4d0d795c0ca8d2b4df8695 Mon Sep 17 00:00:00 2001 From: Matt Bernier Date: Sat, 18 Apr 2015 16:14:59 -0600 Subject: [PATCH 13/17] Changed display title --- source/User_Guide/SendGrid_for_Mobile/subusers.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/User_Guide/SendGrid_for_Mobile/subusers.md b/source/User_Guide/SendGrid_for_Mobile/subusers.md index a4ee43cf0c..20b7cdf5d7 100644 --- a/source/User_Guide/SendGrid_for_Mobile/subusers.md +++ b/source/User_Guide/SendGrid_for_Mobile/subusers.md @@ -1,7 +1,7 @@ --- seo: title: SendGrid for iPhone and iPad Subuser Management -title: SendGrid for iPhone and iPad Subuser Management +title: Subuser Management weight: 500 layout: page navigation: @@ -28,4 +28,4 @@ Here you can view your current subusers and also "impersonate" them, allowing yo The app currently only displays a maximum of 10 subusers. If you have more than 10 subusers, you can pull down and search for the username of a specific subuser not listed. {% endinfo %} -Once you tap on a subuser, you'll be presented with a summary of the account's performance. You can then tap the "Impersonate User" button to "log in" as that subuser, and view the app as that subuser. When impersonating a subuser, you'll find a "Logged In As [subuser name]" banner along the top of the app. You'll also notice that the "Subuser Management" option in the side navigation menu changes to "Log Into Parent Account," which you can use to switch back to your main parent account. \ No newline at end of file +Once you tap on a subuser, you'll be presented with a summary of the account's performance. You can then tap the "Impersonate User" button to "log in" as that subuser, and view the app as that subuser. When impersonating a subuser, you'll find a "Logged In As [subuser name]" banner along the top of the app. You'll also notice that the "Subuser Management" option in the side navigation menu changes to "Log Into Parent Account," which you can use to switch back to your main parent account. From e7cd45b4ef2f7e7e2e1fcd964d80ffe33946a0ee Mon Sep 17 00:00:00 2001 From: Matt Bernier Date: Sat, 18 Apr 2015 16:15:12 -0600 Subject: [PATCH 14/17] Changed display title --- source/User_Guide/SendGrid_for_Mobile/index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/User_Guide/SendGrid_for_Mobile/index.html b/source/User_Guide/SendGrid_for_Mobile/index.html index 611ee62bcd..2aea2fe517 100644 --- a/source/User_Guide/SendGrid_for_Mobile/index.html +++ b/source/User_Guide/SendGrid_for_Mobile/index.html @@ -1,7 +1,7 @@ --- layout: page weight: 900 -title: SendGrid for iPhone and iPad Overview +title: Overview seo: title: SendGrid for iPhone and iPad Overview description: Read about the SendGrid iPhone mobile app and how to use it. From 8069009171698d1cd24c9495b8bff3d5aa05cfb1 Mon Sep 17 00:00:00 2001 From: Matt Bernier Date: Sat, 18 Apr 2015 16:15:23 -0600 Subject: [PATCH 15/17] Changed display title --- source/User_Guide/SendGrid_for_Mobile/email_activity.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/User_Guide/SendGrid_for_Mobile/email_activity.md b/source/User_Guide/SendGrid_for_Mobile/email_activity.md index 9c0aab797d..5bfba956b4 100644 --- a/source/User_Guide/SendGrid_for_Mobile/email_activity.md +++ b/source/User_Guide/SendGrid_for_Mobile/email_activity.md @@ -1,7 +1,7 @@ --- seo: title: SendGrid for iPhone and iPad Email Activity -title: SendGrid for iPhone and iPad Email Activity +title: Email Activity weight: 700 layout: page navigation: @@ -22,4 +22,4 @@ Here you can view the realtime logs of all emails sent from your account in the Tapping on any event will reveal more information, such as server responses or user-agents. -Finally, you can export your Email Activity by selecting the "More" button in the top right corner and selecting "Export". This will create a CSV that you can open in another app on your device. \ No newline at end of file +Finally, you can export your Email Activity by selecting the "More" button in the top right corner and selecting "Export". This will create a CSV that you can open in another app on your device. From 9bacfe163655656f14e2ec62d53e0e3713171399 Mon Sep 17 00:00:00 2001 From: Matt Bernier Date: Sat, 18 Apr 2015 16:15:33 -0600 Subject: [PATCH 16/17] Changed display title --- source/User_Guide/SendGrid_for_Mobile/dashboard.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/User_Guide/SendGrid_for_Mobile/dashboard.md b/source/User_Guide/SendGrid_for_Mobile/dashboard.md index e7940c5251..acd76bdece 100644 --- a/source/User_Guide/SendGrid_for_Mobile/dashboard.md +++ b/source/User_Guide/SendGrid_for_Mobile/dashboard.md @@ -1,7 +1,7 @@ --- seo: title: SendGrid for iPhone and iPad Dashboard -title: SendGrid for iPhone and iPad Dashboard +title: Dashboard weight: 800 layout: page navigation: @@ -20,4 +20,4 @@ navigation: The dashboard page will display your account’s statistics for the past day, week, or month. SendGrid offers a number of [Delivery Metrics]({{root_url}}/User_Guide/Delivery_Metrics/index.html) to report what is happening with your messages. -You can also export the statistics for each individual day to a CSV file by tapping the Share button. \ No newline at end of file +You can also export the statistics for each individual day to a CSV file by tapping the Share button. From 0082fefec38de9f828a5f3b46b3d48ba7c3ee7d6 Mon Sep 17 00:00:00 2001 From: Matt Bernier Date: Mon, 20 Apr 2015 07:55:18 -0600 Subject: [PATCH 17/17] Issue #1024 Closes #1024 --- source/Integrate/Mail_Servers/exim.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/Integrate/Mail_Servers/exim.md b/source/Integrate/Mail_Servers/exim.md index 8d1920ecaf..ab2a938456 100644 --- a/source/Integrate/Mail_Servers/exim.md +++ b/source/Integrate/Mail_Servers/exim.md @@ -56,7 +56,7 @@ $ /etc/init.d/exim4 restart cPanel {% endanchor %} -If you are using cPanel with Exim and want to relay your email through SendGrid, go to **Main \> Service Configuration \> Exim Configuration Editor**, click on the Advanced Editor button, and enter the following: +If you are using cPanel with Exim and want to relay your email through SendGrid, go to **Main \> Service Configuration \> Exim Configuration Editor**, click on the Advanced Editor button, and enter the following in the **AUTH** Box: {% codeblock lang:bash %} begin authenticators