{"id":30794003,"url":"https://github.com/sendgrid/visual_studio_sdk_mail","last_synced_at":"2026-02-12T23:02:36.074Z","repository":{"id":11485402,"uuid":"13957336","full_name":"sendgrid/visual_studio_sdk_mail","owner":"sendgrid","description":null,"archived":false,"fork":false,"pushed_at":"2016-02-20T01:09:27.000Z","size":350,"stargazers_count":2,"open_issues_count":2,"forks_count":2,"subscribers_count":191,"default_branch":"master","last_synced_at":"2025-09-05T16:46:01.624Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sendgrid.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2013-10-29T13:59:37.000Z","updated_at":"2018-12-12T22:02:54.000Z","dependencies_parsed_at":"2022-09-19T13:41:07.736Z","dependency_job_id":null,"html_url":"https://github.com/sendgrid/visual_studio_sdk_mail","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/sendgrid/visual_studio_sdk_mail","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sendgrid%2Fvisual_studio_sdk_mail","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sendgrid%2Fvisual_studio_sdk_mail/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sendgrid%2Fvisual_studio_sdk_mail/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sendgrid%2Fvisual_studio_sdk_mail/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sendgrid","download_url":"https://codeload.github.com/sendgrid/visual_studio_sdk_mail/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sendgrid%2Fvisual_studio_sdk_mail/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29385007,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-12T22:07:52.078Z","status":"ssl_error","status_checked_at":"2026-02-12T22:07:49.026Z","response_time":55,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-09-05T16:26:31.654Z","updated_at":"2026-02-12T23:02:36.060Z","avatar_url":"https://github.com/sendgrid.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# SendGrid SDK Extension #\nThis library allows you to quickly and easily send emails through SendGrid using Visual Studio SDK from your Windows 8 Applications in C# and Javascript and Windows Phone 8 Applications.\n \n## License ##\nLicensed under the MIT License.\n\n## Downloading ##\n\nInstalling the SendGrid SDK Extension is as simple as executing SendGridSdkWindows8.vsix file for Windows 8 Projects or the SendGridSdkWindowsPhone.vsix for Windows Phone 8 Projects and including them as references in your projects.\nThe Windows Phone versions uses Json.Net library which is included in the VSIX installer.\n\n\nIf you're using git, you can just clone down the repo like this:\n\n```\ngit clone git@github.com:sendgrid/visual_studio_sdk.git\n```\n\n__Note__: If you don't have git or would rather install by unpacking a Zip or Tarball, you can always grab the latest version of the package from [the downloads page](https://github.com/sendgrid/visual_studio_sdk/archive/master.zip). \n\n\n## SendGrid API ##\nSendGridSDK provides SendGrid library in C# for sending emails from Windows 8 and Windows Phone 8 Apps.\n\n\n## Mail Pre-Usage ##\n\nBefore we begin using the library, its important to understand a few things about the library architecture...\n\n* The SendGrid object is the means of setting mail data. In general, data can be set in three ways for most elements:\n  1. set - reset the data, and initialize it to the given element. This will destroy previous data\n  2. set (List) - for array based elements, we provide a way of passing the entire array in at once. This will also destroy previous data.\n  3. add - append data to the list of elements.\n\n* Sending an email is as simple as :\n  1. Creating a SendGrid object, and setting its data\n  2. Sending the mail.\n\n## Mail Usage ##\n\nTo begin using this library, you must first install the SDK\n\n\nThen, initialize the SendGrid object with your SendGrid credentials\n\n```JavaScript\nvar SendGrid = new SendGridSDK.Mail(\"\u003csendgrid_username\u003e\",\"\u003csendgrid_password\u003e\");\n```\n\nAdd your message details\n\n```JavaScript\nSendGrid.setTo(\"foo@bar.com\")\n  .setFrom(\"me@bar.com\")\n  .setSubject(\"Subject goes here\")\n  .setText(\"Hello World!\")\n  .setHtml(\"\u003cstrong\u003eHello World!\u003c/strong\u003e\");\n```\n\nSend the email\n\n in Javascript:\n```JavaScript\nSendGrid.send().then(function (results) { console.log(results); });\n```\n in C#:\n```C#\nString results = await SendGrid.send();\n```\n### Using Categories ###\n\nYou can mark messages with optional categories to give better visibility to email statistics (opens, clicks, etc.). You can add up to 10 categories per email message. You can read more about Categories here: http://docs.sendgrid.com/documentation/delivery-metrics/categories/\n\nTo add categories to your message, use the SendGrid.addCategory() method and pass a category as parameter or SendGrid.setCategories() and pass a list of category names. SendGrid will begin tracking statistics with these category names if the category name is new, or aggregate statistics for existing category names.\n\n```JavaScript\nSendGrid.addTo(\"foo@bar.com\")\n  ...\n  .addCategory(\"Category 1\")\n  .addCategory(\"Category 2\");\n```\n\n```JavaScript\nSendGrid.addTo(\"foo@bar.com\")\n  ...\n  .setCategories('[\"Category 1\",\"Category 2\",\"Category 3\"]');\n```\n\n### Using Substitutions ###\n\nSendGrid also allows you to send multi-recipient messages with unique information per recipient. This is commonly used for sending unique URLs or codes to a list of recipients in a single batch. You can read more about Substitutions here: http://docs.sendgrid.com/documentation/api/smtp-api/developers-guide/substitution-tags/\n\n```JavaScript\nSendGrid.addTo(\"john@somewhere.com\")\n  .addTo(\"harry@somewhere.com\")\n  .addTo(\"Bob@somewhere.com\")\n  ...\n  .setHtml(\"Hey %name%, we've seen that you've been gone for a while\")\n  .addSubstitution(\"%name%\", '[\"John\", \"Harry\", \"Bob\"]');\n```\n\n### Using Sections ###\n\nUsed in conjunction with Substitutions, Sections can be used to further customize messages for the end users, and acts like a second tier of substitution data. You can use SendGrid.addSection() to add a single section, or SendGrid.setSections() method to add several sections. You can read more about using Sections here: http://docs.sendgrid.com/documentation/api/smtp-api/developers-guide/section-tags/\n\n```JavaScript\nSendGrid.addTo(\"john@somewhere.com\")\n  .addTo(\"harry@somewhere.com\")\n  .addTo(\"Bob@somewhere.com\")\n  ...\n  .setHtml(\"Hey %name%, you work at %place%\")\n  .addSubstitution(\"%name%\", '[\"John\", \"Harry\", \"Bob\"]')\n  .addSubstitution(\"%place%\",'[\"%office%\", \"%office%\", \"%home%\"]')\n  .addSection(\"%office%\", \"an office\")\n  .addSection(\"%home%\", \"your house\");\n```\n\n### Using Unique Arguments ###\n\nUnique Arguments are used for tracking purposes on the message, and can be seen in the Email Activity screen on your account dashboard or through the Event API. Use the SendGrid.addUniqueArgument() method, which takes two parameters, a key and a value. To pass multiple keys/values, use SendGrid.setUniqueArguments() and pass a dictionary of key/value pairs. More information can be found here: http://docs.sendgrid.com/documentation/api/smtp-api/developers-guide/unique-arguments/\n\n```JavaScript\nSendGrid.addTo(\"foo@bar.com\")\n  ...\n  .addUniqueArgument(\"Customer\", \"Someone\")\n  .addUniqueArgument(\"location\", \"Somewhere\");\n```\n\n### Using Filter Settings ###\n\nFilter Settings are used to enable and disable apps, and to pass parameters to those apps. You can read more here: http://docs.sendgrid.com/documentation/api/smtp-api/filter-settings/\nHere's an example of passing content to the 'footer' app:\n\n```JavaScript\nSendGrid.addTo(\"foo@bar.com\")\n  ...\n  .addFilterSetting(\"footer\", \"enable\", \"1\")\n  .addFilterSetting(\"footer\", \"text/plain\", \"Here is a plain text footer\")\n  .addFilterSetting(\"footer\", \"text/html\", \"\u003cp style='color:red;'\u003eHere is an HTML footer\u003c/p\u003e\");\n```\n\n### Using Bcc ###\n\nBcc is used to send a blind carbon copy to an address\n\n```JavaScript\nSendGrid.setBcc(\"foo@bar.com\")\n```\n\nNote : addBcc() was removed because is currently not supported.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsendgrid%2Fvisual_studio_sdk_mail","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsendgrid%2Fvisual_studio_sdk_mail","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsendgrid%2Fvisual_studio_sdk_mail/lists"}