Skip to content
This repository was archived by the owner on Aug 27, 2021. It is now read-only.

Commit ad35c0e

Browse files
authored
Merge pull request #1924 from sendgrid/develop
6/13/16 Docs Updates
2 parents 6102f71 + 37de2a9 commit ad35c0e

File tree

82 files changed

+397
-61
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

82 files changed

+397
-61
lines changed
Lines changed: 148 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,148 @@
1+
---
2+
layout: page
3+
title: Alerts API
4+
weight: 100
5+
navigation:
6+
show: true
7+
---
8+
9+
Alerts allow you to specify an email address to receive notifications regarding your email usage or statistics.
10+
<br>
11+
<ul>
12+
<li>Usage alerts allow you to set the threshold at which an alert will be sent. For example, if you want to be notified when you've used 90% of your current package's allotted emails, you would set the "percentage" parameter to 90.</li>
13+
<li>Stats notifications allow you to set how frequently you would like to receive email statistics reports. For example, if you want to receive your stats notifications every day, simply set the "frequency" parameter to "daily". Stats notifications include data such as how many emails you sent each day, in addition to other email events such as bounces, drops, unsubscribes, etc.</li>
14+
</ul>
15+
<br>
16+
For more information about alerts, please visit our <a href="{{root_url}}/User_Guide/Settings/alerts.html">User Guide</a>.
17+
18+
19+
FORMAT: 1A
20+
21+
## Alerts Collection [/alerts]
22+
23+
### Get All Alerts [GET]
24+
25+
Retrieve all alerts.
26+
27+
+ Response 200 (application/json)
28+
+ Body
29+
30+
[
31+
{
32+
"created_at": 1451498784,
33+
"email_to": "[email protected]",
34+
"id": 46,
35+
"percentage": 90,
36+
"type": "usage_limit",
37+
"updated_at": 1451498784
38+
},
39+
{
40+
"created_at": 1451498812,
41+
"email_to": "[email protected]",
42+
"frequency": "monthly",
43+
"id": 47,
44+
"type": "stats_notification",
45+
"updated_at": 1451498812
46+
},
47+
{
48+
"created_at": 1451520930,
49+
"email_to": "[email protected]",
50+
"frequency": "daily",
51+
"id": 48,
52+
"type": "stats_notification",
53+
"updated_at": 1451520930
54+
}
55+
]
56+
57+
### Create a New Alert [POST]
58+
59+
Create a new alert. You can create the same alert multiple times, but with different email addresses specified in the "email_to" parameter. This is useful if you have multiple users on the same account who would like to receive the same alerts.
60+
<br>
61+
<br>
62+
63+
+ Attributes (object)
64+
+ type usage_alert (required, string) - The type of alert you want to create. Can be either usage_alert or stats_notification.
65+
+ email_to [email protected] (required, string) - The email address the alert will be sent to.
66+
+ percentage 90 (optional, number) - Required for usage_alert. When this usage threshold is reached, the alert will be sent.
67+
+ frequency daily (optional, string) - Required for stats_notification. How frequently the alert will be sent.
68+
69+
70+
+ Request (application/json)
71+
72+
+ Body
73+
74+
{
75+
"type": "stats_notification",
76+
"email_to": "[email protected]",
77+
"frequency": "daily"
78+
}
79+
80+
+ Response 201 (application/json)
81+
82+
+ Body
83+
84+
{
85+
"created_at": 1451520930,
86+
"email_to": "[email protected]",
87+
"frequency": "daily",
88+
"id": 48,
89+
"type": "stats_notification",
90+
"updated_at": 1451520930
91+
}
92+
93+
## Alerts Collection [/alerts/{alert_id}]
94+
95+
### Get an Alert [GET]
96+
97+
Retrieve a specific alert.
98+
99+
+ Response 200 (application/json)
100+
101+
+ Body
102+
103+
{
104+
"created_at": 1451520930,
105+
"email_to": "[email protected]",
106+
"frequency": "daily",
107+
"id": 48,
108+
"type": "stats_notification",
109+
"updated_at": 1451520930
110+
}
111+
112+
### Delete an Alert [DELETE]
113+
114+
Delete an alert.
115+
116+
+ Response 204
117+
118+
### Update an Alert [PATCH]
119+
120+
Update an alert.
121+
<br>
122+
<br>
123+
124+
+ Attributes
125+
+ email_to [email protected] (optional, string) - The new email address you want your alert to be sent to.
126+
+ frequency monthly (optional, string) - The new frequency at which to send the stats_notification alert.
127+
+ percentage 90 (optional, number) - The new percentage threshold at which the usage_limit alert will be sent.
128+
129+
+ Request (application/json)
130+
131+
+ Body
132+
133+
{
134+
"email_to": "[email protected]"
135+
}
136+
137+
+ Response 200
138+
139+
+ Body
140+
141+
{
142+
"created_at": 1451520930,
143+
"email_to": "[email protected]",
144+
"frequency": "daily",
145+
"id": 48,
146+
"type": "stats_notification",
147+
"updated_at": 1451522691
148+
}

source/Classroom/Basics/Account/how_do_i_add_more_emails_to_my_account.md

Lines changed: 5 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -11,16 +11,15 @@ navigation:
1111
show: true
1212
---
1313

14-
_"Can I add more email to my account?"_ This is a question I hear often from SendGrid users and I would like to clear it all up today. **You cannot manually add more emails to an account,** however most plans allow for overages.
14+
_"Can I add more emails to my account?"_ is a common question from SendGrid users, and the answer is that because of the subscription based model of SendGrid plans, _you cannot manually add more emails to an account_. **However, all plans except for the Free and Legacy Lite plans allow for overages, which means that you can send beyond your monthly allowance for a small per-email fee.**
1515

16-
If you are on the Free plan and need of more emails, you will need to upgrade plans.
1716

18-
**Free plans** have a limit of 12,000 emails per month. After 12,000 requests have been made we will simply reject your requests. It is very import to keep track of how many emails you are sending and you can see this on your account overview page. We have no way to tell you when emails started becoming rejected. :(
17+
**Free plans** have a limit of 12,000 emails per month. After 12,000 requests have been made we will simply reject your requests. It is very import to keep track of how many emails you are sending and you can see this on your account overview page. If you are on the Free plan and are in need of more emails, you will need to [upgrade your account]({{root_url}}/Classroom/Basics/Billing/how_do_i_upgrade_or_downgrade_my_account.html).
1918

20-
**Essentials plan's** have a monthly limit of 40,000/100,000 emails per month but we do allow overages at $1.00 per every 1000 emails.
19+
**Essentials plans** have a monthly limit of 40,000/100,000 emails per month, with overages at a rate of $1.00 per every 1000 emails in excess of your plan limit.
2120

22-
**Pro plan's** have a monthly limit of 100,000, 300,000 and 700,000 emails per month but we do allow overages at $0.85, $0.50 and $0.45 per every 1000 emails.
21+
**Pro plans** have a monthly limit of 100,000, 300,000, or 700,000 emails per month, with overages at a rate of $0.85, $0.50 or $0.45 per every 1000 emails in excess of your plan limit.
2322

24-
**[Legacy Lite plans]({{root_url}}/Classroom/Basics/Billing/legacy_lite_plan.html)** start off with a daily limit of 1000 emails per day for 1 week and the more you send constantly with a good IP reputation, SendGrid will increase your credits. Read more [here](https://sendgrid.com/docs/User_Guide/sending_practices.html) . Again, it is very import to keep track of how many emails you are sending and you can see this on your account overview page.
23+
**[Legacy Lite plans]({{root_url}}/Classroom/Basics/Billing/legacy_lite_plan.html)** start off with a daily limit of 1000 emails per day for 1 week and the more you send constantly with a good IP reputation, SendGrid will increase your credits. Read more [here](https://sendgrid.com/docs/User_Guide/sending_practices.html) . If you are on the Lite plan and are in need of more emails, you will need to [upgrade your account]({{root_url}}/Classroom/Basics/Billing/how_do_i_upgrade_or_downgrade_my_account.html).
2524

2625
![]({{root_url}}/images/Screen_Shot_2015-05-26_at_12.21.47_PM.png)

source/Classroom/Basics/Account/how_do_i_add_more_subusers_to_my_account.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
seo:
33
title: How do I add more subusers to my account?
44
description: How do I add more subusers to my account?
5-
keywords:
5+
keywords: subuser, add, more, need, additional, users
66
title: How do I add more subusers to my account?
77
weight: 0
88
layout: page
@@ -11,7 +11,7 @@ navigation:
1111
show: true
1212
---
1313

14-
By default, we limit the amount of subusers a Pro (or higher) account has to 15. If you find yourself needing more than 15, please contact Support, and we can help you get more added. You'll see the contact Support options at the lower on this page.
14+
By default, we limit the amount of subusers a Pro (or higher) account has to 15. If you find yourself needing more than 15, please contact [SendGrid Support](https://support.sendgrid.com), and we can help you get more added.
1515

1616
Just so you are aware, the support agent will likely ask a few questions about what you will be using subusers for and the volume you might be sending over them. Don't worry though, we're only asking so we can help you have the best experience possible with new subusers.
1717

source/Classroom/Basics/Billing/billing_info_and_faqs.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,7 @@ Credits don't roll over from month to month, any unused credits from the previou
3333

3434
**I missed a payment, what happens next?**
3535

36-
Accounts with outstanding balances over 7 days old will be suspended due to nonpayment. As soon as you can [update your payment info]({{root_url}}/Classroom/Basics/Billing/update_your_credit_card_and_resubmit_payments.html), your account will become active again.
36+
Accounts with outstanding balances over 4-5 days old will be suspended due to nonpayment. As soon as you can [update your payment info]({{root_url}}/Classroom/Basics/Billing/update_your_credit_card_and_resubmit_payments.html), your account will become active again.
3737

3838
Accounts that have unpaid invoices and are still suspended during the last week of the month will be terminated, and access revoked until the balance is settled. Please contact support to get your account re-activated from a billing terminated state.
3939

source/Classroom/Basics/Billing/forgot_to_cancel_or_upgrade.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,4 +17,4 @@ EXAMPLE:
1717

1818
If you request a refund on your $79.95/mo Pro account, and your monthly invoice totals $117.00 due to a combination of overages and contact storage, you are only eligible for a refund of up to 79.95. The remaining 37.05 cannot be refunded in this scenario.
1919

20-
If you need to request a refund, please email &lt;[email protected]&gt;.
20+
If you need to request a refund, please email [[email protected]](mailto:[email protected]).
Lines changed: 39 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,39 @@
1+
---
2+
seo:
3+
title: How to Remove Unusable Contacts
4+
description: Learn how you can delete contacts that result in bounces or spam reports.
5+
keywords: marketing, campaign, unusable, unwanted, contacts
6+
title: How to Remove Unusable Contacts
7+
weight: 0
8+
layout: page
9+
navigation:
10+
show: true
11+
---
12+
13+
It is common to have contacts that result in a group unsubscribe, block, bounce, invalid email address, or spam report. Attempting to send email to these contacts can negatively impact your reputation since these contacts do not want to (and will not) receive your marketing emails. By continuing to store these contacts, you are being charged for recipients that will automatically be dropped.
14+
15+
The following steps will show you how to remove all of your unusable Marketing Campaigns contacts so that you won't continue to be charged for their storage.
16+
17+
1. When viewing your dashboard, navigate to the left hand menu and click **Suppressions**.
18+
19+
2. Open a specific group, such as Bounces or Spam Reports, click the settings cog in the upper right corner, then select **Download as CSV**.
20+
21+
![]({{root_url}}/images/remove_unusable_contacts_1.png)
22+
23+
3. Repeat step 2 for each of the groups that you want to remove (e.g. unsubscribes, spam reports etc.) and merge each of those lists into a single CSV file.
24+
25+
* *Alternatively, you can download all of your contacts from Marketing Campaigns (create a segment defined by "created at" "is after" with a date from 1999 to capture all contacts, and then export that segment).*
26+
* *Next, upload that CSV of all contacts to our [List Assist](https://sendgrid.com/docs/Utilities/list_assist.html) tool. This will give you a CSV of all of your Marketing Campaigns contacts that exist on any of the Suppression lists.*
27+
* *Use that list to follow steps 4-8 below. You can find a video tutorial explaining how to use List Assist [here](https://www.youtube.com/watch?v=FiyDgCl78dk).*
28+
29+
4. Return to your dashboard, navigate to the left hand menu and select **Marketing**, then **Contacts**.
30+
31+
5. In the upper right corner click **Add List or Segment** and select **Upload CSV**.
32+
33+
6. You will be presented with a dialogue box. Select the option to **Create New List** and name it something obvious, like "Remove Invalid Emails."
34+
35+
7. Once uploaded, click the cog to the right of that new list and select **Delete**.
36+
37+
8. Another dialogue box will open asking if you wish to delete "all contacts associated with this list". Make sure that box is checked, and then you're good to go!
38+
39+
![]({{root_url}}/images/remove_unusable_contacts_2.png)

source/Classroom/Basics/Security/what_security_measures_are_available_with_sendgrid_accounts.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ navigation:
1313

1414
**Encryption options**
1515

16-
All email sent via SendGrid will utilize opportunistic encryption using [TLS](https://sendgrid.com/docs/Glossary/tls.html). This means that if your recipients’ mail servers are configured to support TLS, it will be impossible for someone along the route to intercept and/or modify your messages. With opportunistic TLS if the recipient mail server does not support the encryption then the message will then be sent without.
16+
All email sent via SendGrid will utilize [Opportunistic TLS encryption]({{root_url}}/Classroom/Basics/Email_Infrastructure/does_sendgrid_support_end_to_end_tls.html). This means that if your recipients’ mail servers are configured to support TLS, it will be impossible for someone along the route to intercept and/or modify your messages. With opportunistic TLS if the recipient mail server does not support the encryption then the message will then be sent without.
1717

1818
You can read more about which mail servers support TLS in [this blog post](https://sendgrid.com/blog/sendgrid-and-the-future-of-email-security/).
1919

source/Classroom/Deliver/Sender_Authentication/gmail_dmarc_changes.md

Lines changed: 8 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,11 @@
11
---
2+
st:
3+
published_at: 2016-06-13
4+
type: Classroom
25
seo:
36
title: Gmail DMARC Changes
4-
description: Gmail DMARC Changes
5-
keywords: dmarc, gmail, from, spf, dkim
7+
description: 550 5.7.1 Unauthenticated email from domain.tld is not accepted due...
8+
keywords: dmarc, gmail, google, from, spf, dkim
69
title: Gmail DMARC Changes
710
weight: 0
811
layout: page
@@ -13,9 +16,9 @@ navigation:
1316

1417
Gmail has recently decided to embrace [DMARC](http://sendgrid.com/blog/dmarc-domain-based-message-authentication-reporting-conformance/) more explicitly, much like their email brethren, Yahoo and AOL. You may have started seeing bounce messages with the Reason of:
1518

16-
**<NDR GOES HERE > **
19+
**550 5.7.1 Unauthenticated email from domain.tld is not accepted due to domain's DMARC policy. Please contact administrator of domain.tld domain if this was a legitimate mail. Please visit [https://support.google.com/mail/answer/2451690](https://support.google.com/mail/answer/2451690) to learn about DMARC initiative. 62si14044909itw.103 - gsmtp **
1720

18-
This is because Gmail will no longer be accepting messages where the From domain is a Gmail address and the message originates from a non-approved Gmail mail domain server/service. This is a security measure they have implemented to help reduce potential address spoofing of their mail domain.
21+
This is because Gmail will no longer be accepting messages where the From domain is a Gmail address and the message originates from a non-approved Gmail mail domain server/service. This is a security measure they have implemented to help reduce potential address spoofing of their mail domains.
1922

2023

2124

@@ -27,4 +30,4 @@ This is because Gmail will no longer be accepting messages where the From domain
2730

2831

2932

30-
For more extended reading, check out <LINK GOES HERE>, as well as our [DMARC Knowledgebase article](https://sendgrid.zendesk.com/hc/en-us/articles/200182958-Everything-about-DMARC-).
33+
For more extended reading, check out [this article on the DMARC changes](http://www.mediapost.com/publications/article/277884/dmarc-changes-coming-soon-to-an-inbox-near-you.html?utm_source=newsletter&utm_medium=email&utm_content=headline&utm_campaign=93744), as well as our [DMARC Classroom article]({{root_url}}/Classroom/Basics/Email_Infrastructure/everything_about_dmarc.html).
Lines changed: 39 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,39 @@
1+
---
2+
st:
3+
published_at: 2016-06-13
4+
type: Classroom
5+
seo:
6+
title: Microsoft DMARC Changes
7+
description: 550 5.7.1 The messages violates the DMARC policy of...
8+
keywords: dmarc, microsoft, live, outlook, from, spf, dkim, hotmail, msn
9+
title: Microsoft DMARC Changes
10+
weight: 0
11+
layout: page
12+
zendesk_id: 202449646
13+
navigation:
14+
show: true
15+
---
16+
17+
Miscrosoft has recently decided to embrace [DMARC](http://sendgrid.com/blog/dmarc-domain-based-message-authentication-reporting-conformance/) more explicitly, much like their email brethren, Yahoo, AOL, and GMail. You may have started seeing bounce messages with the following reasons:
18+
19+
Hotmail / Outlook / MSN / Live:
20+
21+
**550 5.7.1 The messages violates the DMARC policy of domain.tld (1b6c35a4-2c11-11e6-ab23-549f350a57e2)**
22+
23+
**550 5.2.0 54Qa1t0144ZKE95014QaMR Message rejected due to DMARC. Please see http://postmaster.comcast.net/smtp-error-codes.php#DM000001**
24+
25+
**550 5.2.0 54QF1t03z3oQ44H014QGZ3 Message rejected due to DMARC.**
26+
27+
This is because Microsoft will no longer be accepting messages where the From domain is a Microsoft domain address and the message originates from a non-approved Microsoft mail domain server/service. This is a security measure they have implemented to help reduce potential address spoofing of their mail domains.
28+
29+
30+
31+
**What this means:** As of June, 2016, you can no longer send with the From address being anything from a Microsoft address when sending to a domain that checks DMARC before accepting mail.
32+
33+
**What you can do: ** You will need to change the From address you use in emails to a non-Microsoft address. We recommend using one at your own mail domain, or one you control that is legitimate. You can then set the Reply-To field to be the original Microsoft address that previously was used in the From field.
34+
35+
**What about these messages, are they lost?** : Yes, any send with this bounce message is discarded and tracked as a [Block](http://sendgrid.com/blocks). You will need to adjust your From address field settings, and then try resending from your side.
36+
37+
38+
39+
For more extended reading, check out check out [this article on the DMARC changes](http://www.mediapost.com/publications/article/277884/dmarc-changes-coming-soon-to-an-inbox-near-you.html?utm_source=newsletter&utm_medium=email&utm_content=headline&utm_campaign=93744), as well as our [DMARC Classroom article]({{root_url}}/Classroom/Basics/Email_Infrastructure/everything_about_dmarc.html).

source/Classroom/Send/How_Emails_Are_Sent/how_do_i_send_mail_through_subuser_accounts.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,5 +11,5 @@ navigation:
1111
show: true
1212
---
1313

14-
All you need to do to send mail through a Subuser account is use that account’s SMTP credentials to send mail rather than the parent account credentials. Subusers can also log into [sendgrid.com](http://sendgrid.com/) to take advantage of the [SendGrid Email Marketing App](http://sendgrid.com/newsletter/dashboard). Recipient lists and Newsletter templates are unique to each Subuser account.
14+
All you need to do to send mail through a Subuser account is to simply **use that subuser account’s credentials to send mail via SMTP or API** rather than the parent account credentials. Subusers can also log into [sendgrid.com](http://sendgrid.com/) to take advantage of the [SendGrid Marketing Campaigns]({{root_url}}/User_Guide/Marketing_Campaigns/index.html) tool to send campaigns to stored lists via the online user interface.
1515

0 commit comments

Comments
 (0)