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

Commit

Permalink
Merge pull request #1978 from sendgrid/develop
Browse files Browse the repository at this point in the history
7/1/2016 Docs Updates
  • Loading branch information
eschallock authored Jul 1, 2016
2 parents cff44e7 + d187cc1 commit 4092389
Show file tree
Hide file tree
Showing 7 changed files with 53 additions and 20 deletions.
7 changes: 4 additions & 3 deletions source/API_Reference/Web_API_v3/Mail/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -74,6 +74,7 @@
<li>The total number of recipients must be less than 1000. This includes all recipients defined within the <code>to</code>, <code>cc</code>, and <code>bcc</code> parameters, across each object that you include in the <code>personalizations</code> array.</li>
<li>3000 requests/sec is the maximum rate at which you may call v3 Mail endpoint.</li>
<li>The total length of custom arguments must be less than 10000 bytes.</li>
<li>Unicode encoding is not supported for the <code>from</code> field within the <code>personalizations</code> array.</li>
</ul>

For more specific, parameter level requirements and limitations, see the <a href="#-Request-Body-Parameters">Request Body Parameters documentation</a>.
Expand Down Expand Up @@ -108,16 +109,16 @@
{% api_table_param substitutions "object" No "" "An object following the pattern &#34;substitution_tag&#34;:&#34;value to substitute&#34;. All are assumed to be strings. These substitutions will apply to the content of your email, in addition to the <code>subject</code> and <code>reply-to</code> parameters." 1 %}
{% api_table_param custom_args "object" No "May not exceed 10,000 bytes" "These are values that are specific to this personalization that will be carried along with the email, activity data, and links. Substitutions will not be made on custom arguments. <code>personalizations[x].custom_args</code> will be merged with message level <code>custom_args</code>, overriding any conflicting keys. The combined total size of the resulting custom arguments, after merging, for each personalization may not exceed 10,000 bytes." 1 %}
{% api_table_param send_at integer No "" "A unix timestamp allowing you to specify when you want your email to be sent from SendGrid. <b>This is not necessary if you want the email to be sent at the time of your API request.</b>" 1 %}
{% api_table_param from "object" No "" "An email object containing the email address and name of the sender." 0 %}
{% api_table_param from "object" No "May not include Unicode encoding." "An email object containing the email address and name of the sender. <strong>Unicode encoding is not supported for the <code>from</code> field</strong>." 0 %}
{% api_table_param email string Yes "" "The email address of the sender." 1 %}
{% api_table_param name string No "" "The name of the sender." 1 %}
{% api_table_param reply_to "object" No "" "An email object containing the email address and name of the individual who should receive responses to your email." 0 %}
{% api_table_param email string Yes "" "The email address to which responses will be sent." 1 %}
{% api_table_param name string No "" "The name of the individual who will receive responses to the email." 1 %}
{% api_table_param subject string Yes "" "The subject of your email. This may be overridden by <code>personalizations[x].subject</code>." 0 %}
{% api_table_param content "array of objects" Yes "Min 1" "An array in which you may specify the content of your email. You can include multiple mime types of content, but you must specify at least one. To include more than one mime type, simply add another object to the array containing the <code>type</code> and <code>value</code> parameters. If included, text/plain and text/html must be the first indices of the array in this order. <b>If you choose to include the text/plain or text/html mime types, they must be the first indices of the <code>content<code> array in the order text/plain, text/html.</b>" 0 %}
{% api_table_param type string Yes "Min 1" "The mime type of the content you are including in your email. For example, text/plain or text/html." %}
{% api_table_param value string Yes "Min 1" "The actual content of the specified mime type that you are including in your email." %}
{% api_table_param type string Yes "Min 1" "The mime type of the content you are including in your email. For example, text/plain or text/html." 1 %}
{% api_table_param value string Yes "Min 1" "The actual content of the specified mime type that you are including in your email." 1 %}
{% api_table_param attachments "array of objects" No "" "An array of objects in which you can specify any attachments you want to include." 0 %}
{% api_table_param content string Yes "" "The Base64 encoded content of the attachment." 1 %}
{% api_table_param type string No "" "The mime type of the content you are attaching. For example, application/pdf or image/jpeg." 1 %}
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
---
st:
published_at: 2016-06-07
type: Classroom
seo:
title: Why am I seeing “Credential Resource Already Exists” when I am creating a subuser or credential?
description: Having trouble creating a username...
keywords: username, crendential, subuser, exists, resource
title: Why am I seeing “Credential Resource Already Exists” when I am creating a subuser or credential?
weight: 0
layout: page
navigation:
show: true
---

If you are seeing a message that states "Credential Resource Already Exists" when trying to create a new subuser or credential it is because the chosen username is already in use in the SendGrid user database. As it turns out, every username must be unique and not in use by any other SendGrid account. In order to successfully create a new subuser or credential after receiving this message, you will need to change the chosen username slightly by adding additional characters or choosing a new username.
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
---
st:
published_at: 2016-06-07
type: Classroom
seo:
title: I have an account through a third party partner that leverages SendGrid's services. Why can’t I access your new Marketing Campaigns feature?
description: Unable to access Marketing Campaigns with another service...
keywords: marketing, campaigns, azure, heroku, partner,
title: I have an account through a third party partner that leverages SendGrid's services. Why can’t I access your new Marketing Campaigns feature?
weight: 0
layout: page
navigation:
show: true
---

[Marketing Campaigns]({{root_url}}/User_Guide/Marketing_Campaigns/index.html) is currently not available for customers using third party partner services such as Azure, Heroku, etc... Although the feature is visible on the dashboard, it is not accessable to third party partner accounts at this time. This is a feature we hope will be available in the future. If you believe you did have access to Marketing Campaigns and it is no longer available, we will check and reactivate if necessary.
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
---
st:
published_at: 2016-06-07
type: Classroom
seo:
title: Why is sendgrid.net “greylisted”?
description: Noticing sendgrid.net is greylisted...
keywords: grey, list, greylist, greylisted, deliverability
title: Why is sendgrid.net “greylisted”?
weight: 0
layout: page
navigation:
show: true
---

We are aware that "sendgrid.net" is on a URIBL Greylist and have been monitoring it very closely. We are consistently in contact with the organizers of the list and are working closely to remove "sendgrid.net". Currently, there is no evidence of any actual impact on deliverability due to the greylisting. If you have evidence of blocks or bounces resulting directly because of this listing, please reach out to support [here](https://support.sendgrid.com/hc/en-us).
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ navigation:
show: true
---

Currently there is not a way to download a log or a .csv of your Click, Open, or any other email event data directly from . We recommend implementing our [Event Notification Webhook](https://app.sendgrid.com/settings/mail_settings) if you find yourself needing to log and access your data more granularly.
Currently there is not a way to download a log or a .csv of your Click, Open, or any other email event data directly from the SendGrid customer portal. We recommend implementing our [Event Notification Webhook](https://app.sendgrid.com/settings/mail_settings) if you find yourself needing to log and access your data more granularly.

You can also use our [open source EventKit app]({{root_url}}/Utilities/event_kit.html) to set up a basic implementation of our Event Notification Webhook, and will grant you the ability to download a .csv of email data from the EventKit interface for any events that are collected _after the setup is complete_.

15 changes: 0 additions & 15 deletions source/Classroom/Track/Drops/delivery_rate_drops_rate.md

This file was deleted.

1 change: 0 additions & 1 deletion source/Classroom/Track/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -81,7 +81,6 @@ <h2><a href="#Tracking-Unsubscribes">Tracking Unsubscribes</a></h2>
<div class="col-md-12">
{% anchor h2 %}Tracking Drops{% endanchor %}
<ul>
<li><a href="{{root_url}}Drops/delivery_rate_drops_rate.html">What does the "Daily delivery rate drops below X%" alert measure?</a></li>
<li><a href="{{root_url}}Drops/drop_reason_bounced_address.html">Drop Reason&#58; Bounced Address</a></li>
<li><a href="{{root_url}}Drops/drop_reason_unsubscribed_address.html">Drop Reason&#58; Unsubscribed Address</a></li>
</ul>
Expand Down

0 comments on commit 4092389

Please sign in to comment.