{"id":7827,"date":"2013-04-12T13:55:13","date_gmt":"2013-04-12T13:55:13","guid":{"rendered":"https:\/\/www.thenewsletterplugin.com\/?page_id=7827"},"modified":"2025-05-28T09:01:37","modified_gmt":"2025-05-28T09:01:37","slug":"sendgrid-extension","status":"publish","type":"page","link":"https:\/\/www.thenewsletterplugin.com\/documentation\/addons\/delivery-addons\/sendgrid-extension\/","title":{"rendered":"SendGrid Addon"},"content":{"rendered":"\n<p>This add-on provides integration with\u00a0<a href=\"https:\/\/www.thenewsletterplugin.com\/affiliate\/sendgrid\" target=\"_blank\" rel=\"noopener noreferrer\">SendGrid<\/a>\u00a0and bouncing detection service.<\/p>\n\n\n\n<h3>What's inside<\/h3><ul class=\"tnp-summary\"><li class=\"level-1\"><a href=\"#api-3\">Using the API 3 method<\/a><\/li><li class=\"level-1\"><a href=\"#unsubscribe\">Unsubscribe link<\/a><\/li><li class=\"level-1\"><a href=\"#bounces\">Bounces and Complaints Management<\/a><\/li><\/ul>\n\n\n\n<p>SendGrid is an email delivery&nbsp;service you can use to send emails from your Newsletter plugin solving most of the problems caused by provider limitations (blacklisted servers, strict limits, reliability, &#8230;).<\/p>\n\n\n\n<p>From time to time they change the pricing and the plans, so check out the plan that is better for you. Surely they have at least a free trial, it&#8217;s a perfect starting point.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"api-3\">Using the API 3 method<\/h2>\n\n\n\n<p class=\"is-style-warning\">There could&nbsp;be a little problem with <strong>old Sendgrid accounts<\/strong> since Sendgrid left the old account in an old platform where the API v3 is <strong>not supported<\/strong>. Ask the SendGrid customer support if your account can use the API Version 3 and, if not, to migrate the account to their new platform.<\/p>\n\n\n\n<p>Go to <strong>your SendGrid dashboard<\/strong> to create an<strong> API key by following the Settings menu and selecting<\/strong> <strong>API keys<\/strong>. They can change without notice the menu and the dashboard organization so you may find this feature moved under another menu. Press the button &#8220;Create API Key&#8221;.<\/p>\n\n\n\n<p>When you add a new API key they&#8217;ll ask the permissions you want to give it. You can select to give full access, but the minimum permissions are the Mail Send and the Mail Settings:<\/p>\n\n\n\n<figure class=\"wp-block-image\"><img decoding=\"async\" src=\"https:\/\/www.thenewsletterplugin.com\/wp-content\/uploads\/2018\/06\/sendgrid-1.png\" alt=\"\" class=\"wp-image-103469\"\/><figcaption class=\"wp-element-caption\">Example of API creation with full permissions<\/figcaption><\/figure>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"151\" src=\"https:\/\/www.thenewsletterplugin.com\/documentation\/wp-content\/uploads\/2024\/06\/sendgrid-api-permissions-1024x151.jpg\" alt=\"\" class=\"wp-image-200358\" srcset=\"https:\/\/www.thenewsletterplugin.com\/documentation\/wp-content\/uploads\/2024\/06\/sendgrid-api-permissions-1024x151.jpg 1024w, https:\/\/www.thenewsletterplugin.com\/documentation\/wp-content\/uploads\/2024\/06\/sendgrid-api-permissions-300x44.jpg 300w, https:\/\/www.thenewsletterplugin.com\/documentation\/wp-content\/uploads\/2024\/06\/sendgrid-api-permissions-768x113.jpg 768w, https:\/\/www.thenewsletterplugin.com\/documentation\/wp-content\/uploads\/2024\/06\/sendgrid-api-permissions.jpg 1265w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><figcaption class=\"wp-element-caption\">Minimum permissions that are required by the addon to use the SendGrid delivery and bounce notification service.<\/figcaption><\/figure>\n<\/div>\n\n\n<p>Press the button &#8220;Create &amp; View&#8221; and&nbsp;<strong>copy the API key in a safe place<\/strong>&nbsp;since it won&#8217;t be shown again.<\/p>\n\n\n\n<p>Set the API key on the SendGrid addon configuration panel, save, and make a test. Shortly an email should be delivered to the selected test email address and be logged in the SendGrid console.<\/p>\n\n\n\n<p>Do a connection test <strong>before<\/strong> enabling the extension. Once enabled, Newsletter starts to use it so you must be sure it is correctly working.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"unsubscribe\">Unsubscribe link<\/h2>\n\n\n\n<p>Sendgrid offers a way to add an unsubscribe link to each outgoing email that is not related to the Newsletter plugin unsubscribe process. Since the Newsletter plugin manages the cancellation process with its own tags (<code>{unsubscription_url}<\/code> and <code>{unsubscription_confirm_url}<\/code>), you can disable that SendGrid link from the settings\/tracing panel on your Sendgrid console:<\/p>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter\"><a href=\"https:\/\/www.thenewsletterplugin.com\/wp-content\/uploads\/2018\/08\/sendgrid-unsubscribe.png\"><img decoding=\"async\" src=\"https:\/\/www.thenewsletterplugin.com\/wp-content\/uploads\/2018\/08\/sendgrid-unsubscribe-1024x313.png\" alt=\"\" class=\"wp-image-116677\"\/><\/a><\/figure>\n<\/div>\n\n\n<h2 class=\"wp-block-heading\" id=\"bounces\">Bounces and Complaints Management<\/h2>\n\n\n\n<p>The SendGrid add-on configures SendGrid to call back to report bounces, complaints, and possibly other events that lead to a change in the subscriber status. Technically that is called a &#8220;webhook&#8221;.<\/p>\n\n\n\n<p class=\"is-style-warning\">A notice can appear on the configuration page of the addon, reporting the maximum number of webhooks has been reached. On free accounts only a webhook can be created, you should delete the one you find on SendGrid (<a href=\"https:\/\/app.sendgrid.com\/settings\/mail_settings\/webhook_settings\" target=\"_blank\" rel=\"noreferrer noopener\">on this page<\/a>) and re-save the addon settings to have the webhook set automatically.<\/p>\n\n\n\n<p><\/p>\n","protected":false},"excerpt":{"rendered":"<p>This add-on provides integration with\u00a0SendGrid\u00a0and bouncing detection service. SendGrid is an email delivery&nbsp;service you can use to send emails from your Newsletter plugin solving most of the problems caused by provider limitations (blacklisted servers, strict limits, reliability, &#8230;). From time to time they change the pricing and the plans, so check out the plan that &#8230; <a title=\"SendGrid Addon\" class=\"read-more\" href=\"https:\/\/www.thenewsletterplugin.com\/documentation\/addons\/delivery-addons\/sendgrid-extension\/\" aria-label=\"Read more about SendGrid Addon\">Read more<\/a><\/p>\n","protected":false},"author":3,"featured_media":201112,"parent":198066,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-7827","page","type-page","status-publish","has-post-thumbnail"],"_links":{"self":[{"href":"https:\/\/www.thenewsletterplugin.com\/documentation\/wp-json\/wp\/v2\/pages\/7827","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.thenewsletterplugin.com\/documentation\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/www.thenewsletterplugin.com\/documentation\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/www.thenewsletterplugin.com\/documentation\/wp-json\/wp\/v2\/users\/3"}],"replies":[{"embeddable":true,"href":"https:\/\/www.thenewsletterplugin.com\/documentation\/wp-json\/wp\/v2\/comments?post=7827"}],"version-history":[{"count":5,"href":"https:\/\/www.thenewsletterplugin.com\/documentation\/wp-json\/wp\/v2\/pages\/7827\/revisions"}],"predecessor-version":[{"id":200365,"href":"https:\/\/www.thenewsletterplugin.com\/documentation\/wp-json\/wp\/v2\/pages\/7827\/revisions\/200365"}],"up":[{"embeddable":true,"href":"https:\/\/www.thenewsletterplugin.com\/documentation\/wp-json\/wp\/v2\/pages\/198066"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.thenewsletterplugin.com\/documentation\/wp-json\/wp\/v2\/media\/201112"}],"wp:attachment":[{"href":"https:\/\/www.thenewsletterplugin.com\/documentation\/wp-json\/wp\/v2\/media?parent=7827"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}