Skip to content
This repository was archived by the owner on Aug 27, 2021. It is now read-only.
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
33 changes: 8 additions & 25 deletions source/API_Reference/SMTP_API/scheduling_parameters.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,11 +6,11 @@ navigation:
show: true
---

With scheduling you can send large volumes of email in queued batches or target individual recipients by specifying custom UNIX timestamp parameter.
Using the parameters defined below, you can queue batches of emails targeting individual recipients.
With scheduling you can send large volumes of email in queued batches or target individual recipients by specifying custom UNIX timestamp parameter.
Using the parameters defined below, you can queue batches of emails targeting individual recipients.

This parameter allows SendGrid to begin processing a customer’s email requests before sending. SendGrid will then queue those messages and release
them when the timestamp is exceeded. This technique allows for a more efficient way to distribute large email requests and can **improve overall mail delivery time**
This parameter allows SendGrid to begin processing a customer’s email requests before sending. SendGrid will then queue those messages and release
them when the timestamp is exceeded. This technique allows for a more efficient way to distribute large email requests and can **improve overall mail delivery time**
performance. This functionality:

* Improves efficiency of processing and distributing large volumes of email.
Expand All @@ -29,8 +29,8 @@ Using both `send_at` and `send_each_at` is not valid and will cause your request

{% anchor h2 %}
Send At
{% endanchor %}
{% endanchor %}

To schedule a send request for a large batch of emails use the `send_at` parameter which will send all emails at approximately the same time. `send_at` is a [UNIX timestamp](https://en.wikipedia.org/wiki/Unix_time).

<h4>Example of send_at email header</h4>
Expand All @@ -42,8 +42,8 @@ To schedule a send request for a large batch of emails use the `send_at` paramet

{% anchor h2 %}
Send Each At
{% endanchor %}
{% endanchor %}

To schedule a send request for individual recipients; use `send_each_at` to send emails to each recipient at the specified time. `send_each_at` is a sequence of UNIX timestamps, provided as an array. There must be one timestamp per email you wish to send.

<h4>Example of send_each_at email header</h4>
Expand All @@ -61,20 +61,3 @@ To schedule a send request for individual recipients; use `send_each_at` to send
]
}
{% endcodeblock %}

To allow for the cancellation of a scheduled send, you must include a batch id with your send. The endpoint for cancellation needs a batch id to cancel with. To generate a valid batch id, use the batch id generation endpoint

<h4>Example of including a batch_id</h4>
{% codeblock lang:json %}
{
"to": [
"<[email protected]>",
"[email protected]",
"[email protected]"
],
"send_at": [
1409348513
],
"batch_id": "MWQxZmIyODYtNjE1Ni0xMWU1LWI3ZTUtMDgwMDI3OGJkMmY2LWEzMmViMjYxMw"
}
{% endcodeblock %}
2 changes: 2 additions & 0 deletions source/Integrate/Code_Examples/csharp.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,8 @@ mail.Text = "and easy to do anywhere, even with C#";
var credentials = new NetworkCredential(api_user, api_key);
var transportWeb = new Web(credentials);
transportWeb.DeliverAsync(mail);
// If developing a Console Application, use the following
// transportWeb.DeliverAsync(mail).Wait();
{% endcodeblock %}

{% anchor h2 %}
Expand Down