{"id":22801102,"url":"https://github.com/iowacomputergurus/netcore.utilities.email.sendgrid","last_synced_at":"2025-04-19T18:22:21.966Z","repository":{"id":37898365,"uuid":"379798714","full_name":"IowaComputerGurus/netcore.utilities.email.sendgrid","owner":"IowaComputerGurus","description":"A utility library for working with templated email delivery using SendGrid as the outbound delivery service","archived":false,"fork":false,"pushed_at":"2025-04-07T08:46:20.000Z","size":183,"stargazers_count":1,"open_issues_count":3,"forks_count":0,"subscribers_count":2,"default_branch":"develop","last_synced_at":"2025-04-14T16:53:11.335Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/IowaComputerGurus.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":["iowacomputergurus","mitchelsellers"]}},"created_at":"2021-06-24T04:03:19.000Z","updated_at":"2025-02-16T08:09:41.000Z","dependencies_parsed_at":"2025-02-16T09:17:29.874Z","dependency_job_id":"96dbfaee-efcc-4204-935a-adee4a72e08f","html_url":"https://github.com/IowaComputerGurus/netcore.utilities.email.sendgrid","commit_stats":{"total_commits":26,"total_committers":3,"mean_commits":8.666666666666666,"dds":"0.46153846153846156","last_synced_commit":"65672a9c65301a4459c8fc6ffb9698021ad93bb3"},"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IowaComputerGurus%2Fnetcore.utilities.email.sendgrid","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IowaComputerGurus%2Fnetcore.utilities.email.sendgrid/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IowaComputerGurus%2Fnetcore.utilities.email.sendgrid/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IowaComputerGurus%2Fnetcore.utilities.email.sendgrid/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/IowaComputerGurus","download_url":"https://codeload.github.com/IowaComputerGurus/netcore.utilities.email.sendgrid/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249761798,"owners_count":21321860,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":"2024-12-12T08:08:58.592Z","updated_at":"2025-04-19T18:22:21.949Z","avatar_url":"https://github.com/IowaComputerGurus.png","language":"C#","funding_links":["https://github.com/sponsors/iowacomputergurus","https://github.com/sponsors/mitchelsellers"],"categories":[],"sub_categories":[],"readme":"# ICG.NetCore.Utilities.Email.SendGrid ![](https://img.shields.io/github/license/iowacomputergurus/netcore.utilities.email.SendGrid.svg)\n\n![Build Status](https://github.com/IowaComputerGurus/netcore.utilities.email/actions/workflows/ci-build.yml/badge.svg)\n\n![](https://img.shields.io/nuget/v/icg.netcore.utilities.email.sendgrid.svg) ![](https://img.shields.io/nuget/dt/icg.netcore.utilities.email.sendgrid.svg)\n\nThis library provides an easy to use implementation of SendGrid based email delivery.  This abstraction with proper interfaces allows email implementation inside of your project with little effort and easy to manage integration, and boasts features such as automatic environment name appending as well as robust email templates.\n\nThis package depends on the ICG.NetCore.Utilities.Email project for template implementation\n\n## Breaking Changes\n\nVersion 7.0 has a breaking change transitioning to Async for all methods!\n\n## Dependencies\nThe following additional NuGet packages are installed with this extension.\n\n* [SendGrid](https://www.nuget.org/packages/SendGrid/) - For email delivery\n* [ICG NET Core Utilities Email](https://github.com/IowaComputerGurus/netcore.utilities.email) - For Email Template Configuration\n\n## Usage\n\n### Installation\nStandard installation via HuGet Package Manager\n``` powershell\nInstall-Package ICG.NetCore.Utilities.Email.SendGrid\n```\n\n### Setup \u0026 Configuration Options\nTo setup the needed dependency injection items for this library, add the following line in your DI setup.\n``` csharp\nservices.UseIcgNetCoreUtilitiesEmailSendGrid();\n```\n\nAdditionally you must specify the needed configuration elements within your AppSettings.json file\n\n``` json\n  \"SendGridServiceOptions\": {\n    \"AdminEmail\": \"test@test.com\",\n    \"AdminName\": \"John Smith\",\n    \"SendGridApiKey\": \"YourKey\",\n    \"AdditionalApiKeys\": { \"SpecialSender\": \"SpecialKey\" }\n    \"AlwaysTemplateEmails\": true,\n    \"AddEnvironmentSuffix\": true\n  },\n  \"EmailTemplateSettings\": {\n    \"DefaultTemplatePath\": \"Template.html\",\n    \"AdditionalTemplates\": { \"SpecialTemplate\": \"File.html\" }\n  }\n```\n\n\n| Setting | Description |\n| --- | --- |\n| AdminEmail | This is the email address used as the \"from\" address and also for any usage of the \"SendToAdministrator\" option |\n| AdminName | If specified this is the name that will be used for the \"From\" address on all outbound emails |\n| SendGridApiKey | The API Key to use for default sending of email addresses |\n| AdditionalApiKeys | These are name/value pairs of additional API keys that could be used for sending emails.  Totally optional |\n| AlwaysTemplateEmails | If selected ALL emails sent will be templated, by default using the \"DefaultTemplate\" as configured |\n| AddEnvironmentSuffix | If selected, all outbound emails sent from non-production addresses will have the environment name added to the end of the subject |\n| DefaultTemplatePath | The path, relative to the application root, where the default HTML template can be found for emails |\n| AdditionalTemplates | These are name/value pairs of additional templates and totally optional |\n\n\n### Usage\n\nUsage is primarly completed by injecting the IEmailService interface to your respective project, one injected emails can be sent with a single line of code. \n\n``` csharp\n_sendGridService.SendEmail(\"recipient@me.com\", \"My Subject\", \"\u003cp\u003eHello!\u003c/p\u003e\");\n```\nInline documentation exists for all API methods. We will continue to add more to this documentation in the future (PR's Welcome)\n\n## Related Projects\n\nICG has a number of other related projects as well\n\n* [AspNetCore.Utilities](https://www.github.com/iowacomputergurus/aspnetcore.utilities)\n* [NetCore.Utilities.Email.Smtp](https://www.github.com/iowacomputergurus/netcore.utilities.Email.Smtp)\n* [NetCore.Utilities.Spreadsheet](https://www.github.com/iowacomputergurus/netcore.utilities.spreadsheet)\n* [NetCore.Utilities.UnitTesting](https://www.github.com/iowacomputergurus/netcore.utilities.unittesting)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiowacomputergurus%2Fnetcore.utilities.email.sendgrid","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fiowacomputergurus%2Fnetcore.utilities.email.sendgrid","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiowacomputergurus%2Fnetcore.utilities.email.sendgrid/lists"}