sendgrid · coolaj86 · Oct 28, 2020
diff --git a/.prettierrc b/.prettierrc
@@ -0,0 +1 @@
+{}
diff --git a/README.md b/README.md
@@ -2,7 +2,7 @@
 
 [![BuildStatus](https://travis-ci.org/sendgrid/sendgrid-go.svg?branch=main)](https://travis-ci.org/sendgrid/sendgrid-go)
 [![Email Notifications Badge](https://dx.sendgrid.com/badge/go)](https://dx.sendgrid.com/newsletter/go)
-[![GoDoc](https://godoc.org/github.com/sendgrid/sendgrid-go?status.svg)](https://godoc.org/github.com/sendgrid/sendgrid-go)
+[![GoDoc](https://godoc.org/github.com/sendgrid/sendgrid-go?status.svg)](https://pkg.go.dev/github.com/sendgrid/sendgrid-go/v3)
 [![MIT licensed](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
 [![Twitter Follow](https://img.shields.io/twitter/follow/sendgrid.svg?style=social&label=Follow)](https://twitter.com/sendgrid)
 [![GitHub contributors](https://img.shields.io/github/contributors/sendgrid/sendgrid-go.svg)](https://github.com/sendgrid/sendgrid-go/graphs/contributors)
@@ -24,23 +24,24 @@ We appreciate your continued support, thank you!
 
 # Table of Contents
 
-* [Installation](#installation)
-* [Quick Start](#quick-start)
-* [Processing Inbound Email](#inbound)
-* [Usage](#usage)
-* [Use Cases](#use-cases)
-* [Announcements](#announcements)
-* [How to Contribute](#contribute)
-* [Troubleshooting](#troubleshooting)
-* [About](#about)
-* [License](#license)
+- [Installation](#installation)
+- [Quick Start](#quick-start)
+- [Processing Inbound Email](#inbound)
+- [Usage](#usage)
+- [Use Cases](#use-cases)
+- [Announcements](#announcements)
+- [How to Contribute](#contribute)
+- [Troubleshooting](#troubleshooting)
+- [About](#about)
+- [License](#license)
 
 <a name="installation"></a>
+
 # Installation
 
 ## Prerequisites
 
-- Go version 1.7
+- Go version 1.12
 - The Twilio SendGrid service, starting at the [free level](https://sendgrid.com/free?source=sendgrid-go), to send up to 40,000 emails for the first 30 days, then send 100 emails/day free forever or check out [our pricing](https://sendgrid.com/pricing?source=sendgrid-go).
 
 ## Setup Environment Variables
@@ -55,7 +56,7 @@ source ./sendgrid.env
 
 ## Install Package
 
-`go get github.com/sendgrid/sendgrid-go`
+`go get github.com/sendgrid/sendgrid-go/v3`
 
 ## Dependencies
 
@@ -80,6 +81,7 @@ source ./sendgrid.env
 ```
 
 <a name="quick-start"></a>
+
 # Quick Start
 
 ## Hello Email
@@ -96,8 +98,8 @@ import (
 	"log"
 	"os"
 
-	"github.com/sendgrid/sendgrid-go"
-	"github.com/sendgrid/sendgrid-go/helpers/mail"
+	"github.com/sendgrid/sendgrid-go/v3"
+	"github.com/sendgrid/sendgrid-go/v3/helpers/mail"
 )
 
 func main() {
@@ -130,7 +132,7 @@ package main
 
 import (
 	"fmt"
-	"github.com/sendgrid/sendgrid-go"
+	"github.com/sendgrid/sendgrid-go/v3"
 	"log"
 	"os"
 )
@@ -177,7 +179,7 @@ package main
 
 import (
 	"fmt"
-	"github.com/sendgrid/sendgrid-go"
+	"github.com/sendgrid/sendgrid-go/v3"
 	"log"
 	"os"
 )
@@ -197,13 +199,14 @@ func main() {
 }
 ```
 
-
 <a name="inbound"></a>
+
 # Processing Inbound Email
 
 Please see [our helper](helpers/inbound) for utilizing our Inbound Parse webhook.
 
 <a name="usage"></a>
+
 # Usage
 
 - [Twilio SendGrid Docs](https://sendgrid.com/docs/API_Reference/index.html)
@@ -213,18 +216,21 @@ Please see [our helper](helpers/inbound) for utilizing our Inbound Parse webhook
 - [v3 Web API Mail Send Helper](helpers/mail/README.md)
 
 <a name="use-cases"></a>
+
 # Use Cases
 
 [Examples of common API use cases](use-cases/README.md), such as how to send an email with a transactional template.
 
 <a name="announcements"></a>
+
 # Announcements
 
 Please see our announcement regarding [breaking changes](https://github.com/sendgrid/sendgrid-go/issues/81). Your support is appreciated!
 
 All updates to this library are documented in our [CHANGELOG](CHANGELOG.md) and [releases](https://github.com/sendgrid/sendgrid-go/releases). You may also subscribe to email [release notifications](https://dx.sendgrid.com/newsletter/go) for releases and breaking changes.
 
 <a name="contribute"></a>
+
 # How to Contribute
 
 We encourage contribution to our libraries (you might even score some nifty swag), please see our [CONTRIBUTING](CONTRIBUTING.md) guide for details.
@@ -237,11 +243,13 @@ Quick links:
 - [Review Pull Requests](CONTRIBUTING.md#code-reviews)
 
 <a name="troubleshooting"></a>
+
 # Troubleshooting
 
 Please see our [troubleshooting guide](TROUBLESHOOTING.md) for common library issues.
 
 <a name="about"></a>
+
 # About
 
 sendgrid-go is maintained and funded by Twilio SendGrid, Inc. The names and logos for sendgrid-go are trademarks of Twilio SendGrid, Inc.
@@ -251,4 +259,5 @@ If you need help installing or using the library, please check the [Twilio SendG
 If you've instead found a bug in the library or would like new features added, go ahead and open issues or pull requests against this repo!
 
 # License
+
 [The MIT License (MIT)](LICENSE)
diff --git a/USAGE.md b/USAGE.md
@@ -7,7 +7,7 @@ package main
 
 import (
 	"fmt"
-	"github.com/sendgrid/sendgrid-go"
+	"github.com/sendgrid/sendgrid-go/v3"
 	"log"
 	"os"
 )

diff --git a/base_interface.go b/base_interface.go
@@ -7,7 +7,7 @@ import (
 	"time"
 
 	"github.com/sendgrid/rest"
-	"github.com/sendgrid/sendgrid-go/helpers/mail"
+	"github.com/sendgrid/sendgrid-go/v3/helpers/mail"
 )
 
 // Version is this client library's current version

diff --git a/examples/accesssettings/accesssettings.go b/examples/accesssettings/accesssettings.go
@@ -5,7 +5,7 @@ import (
 	"log"
 	"os"
 
-	sendgrid "github.com/sendgrid/sendgrid-go"
+	sendgrid "github.com/sendgrid/sendgrid-go/v3"
 )
 
 // Retrieveallrecentaccessattempts : Retrieve all recent access attempts

diff --git a/examples/alerts/alerts.go b/examples/alerts/alerts.go
@@ -5,7 +5,7 @@ import (
 	"log"
 	"os"
 
-	"github.com/sendgrid/sendgrid-go"
+	"github.com/sendgrid/sendgrid-go/v3"
 )
 
 // CreateanewAlert : Create a new Alert

diff --git a/examples/apikeys/apikeys.go b/examples/apikeys/apikeys.go
@@ -5,7 +5,7 @@ import (
 	"log"
 	"os"
 
-	sendgrid "github.com/sendgrid/sendgrid-go"
+	sendgrid "github.com/sendgrid/sendgrid-go/v3"
 )
 
 // CreateAPIkeys : Create API keys

diff --git a/examples/asm/asm.go b/examples/asm/asm.go
@@ -5,7 +5,7 @@ import (
 	"log"
 	"os"
 
-	"github.com/sendgrid/sendgrid-go"
+	"github.com/sendgrid/sendgrid-go/v3"
 )
 
 // Createanewsuppressiongroup : Create a new suppression group

diff --git a/examples/browsers/browsers.go b/examples/browsers/browsers.go
@@ -5,7 +5,7 @@ import (
 	"log"
 	"os"
 
-	sendgrid "github.com/sendgrid/sendgrid-go"
+	sendgrid "github.com/sendgrid/sendgrid-go/v3"
 )
 
 // Retrieveemailstatisticsbybrowser : Retrieve email statistics by browser.

diff --git a/examples/campaigns/campaigns.go b/examples/campaigns/campaigns.go
@@ -5,7 +5,7 @@ import (
 	"log"
 	"os"
 
-	sendgrid "github.com/sendgrid/sendgrid-go"
+	sendgrid "github.com/sendgrid/sendgrid-go/v3"
 )
 
 // CreateaCampaign : Create a Campaign

diff --git a/examples/categories/categories.go b/examples/categories/categories.go
@@ -5,7 +5,7 @@ import (
 	"log"
 	"os"
 
-	"github.com/sendgrid/sendgrid-go"
+	"github.com/sendgrid/sendgrid-go/v3"
 )
 
 // Retrieveallcategories : Retrieve all categories

diff --git a/examples/clients/clients.go b/examples/clients/clients.go
@@ -5,7 +5,7 @@ import (
 	"log"
 	"os"
 
-	"github.com/sendgrid/sendgrid-go"
+	"github.com/sendgrid/sendgrid-go/v3"
 )
 
 // Retrieveemailstatisticsbyclienttype : Retrieve email statistics by client type.

diff --git a/examples/contactdb/contactdb.go b/examples/contactdb/contactdb.go
@@ -5,7 +5,7 @@ import (
 	"log"
 	"os"
 
-	"github.com/sendgrid/sendgrid-go"
+	"github.com/sendgrid/sendgrid-go/v3"
 )
 
 // CreateaCustomField : Create a Custom Field

diff --git a/examples/devices/devices.go b/examples/devices/devices.go
@@ -5,7 +5,7 @@ import (
 	"log"
 	"os"
 
-	"github.com/sendgrid/sendgrid-go"
+	"github.com/sendgrid/sendgrid-go/v3"
 )
 
 // Retrieveemailstatisticsbydevicetype : Retrieve email statistics by device type.

diff --git a/examples/eventwebhook/eventwebhook.go b/examples/eventwebhook/eventwebhook.go
@@ -6,8 +6,8 @@ import (
 	"os"
 
 	"github.com/sendgrid/rest"
-	"github.com/sendgrid/sendgrid-go"
-	"github.com/sendgrid/sendgrid-go/helpers/eventwebhook"
+	"github.com/sendgrid/sendgrid-go/v3"
+	"github.com/sendgrid/sendgrid-go/v3/helpers/eventwebhook"
 )
 
 // EnableSignedWebhook : Enables Signed Event Webhook.

diff --git a/examples/geo/geo.go b/examples/geo/geo.go
@@ -5,7 +5,7 @@ import (
 	"log"
 	"os"
 
-	"github.com/sendgrid/sendgrid-go"
+	"github.com/sendgrid/sendgrid-go/v3"
 )
 
 // Retrieveemailstatisticsbycountryandstateprovince : Retrieve email statistics by country and state/province.

diff --git a/examples/helpers/mail/example.go b/examples/helpers/mail/example.go
@@ -6,8 +6,8 @@ import (
 	"fmt"
 	"os"
 
-	"github.com/sendgrid/sendgrid-go"
-	"github.com/sendgrid/sendgrid-go/helpers/mail"
+	"github.com/sendgrid/sendgrid-go/v3"
+	"github.com/sendgrid/sendgrid-go/v3/helpers/mail"
 )
 
 // Minimum required to send an email

diff --git a/examples/ips/ips.go b/examples/ips/ips.go
@@ -5,7 +5,7 @@ import (
 	"log"
 	"os"
 
-	"github.com/sendgrid/sendgrid-go"
+	"github.com/sendgrid/sendgrid-go/v3"
 )
 
 // RetrieveallIPaddresses : Retrieve all IP addresses

diff --git a/examples/mail/mail.go b/examples/mail/mail.go
@@ -5,7 +5,7 @@ import (
 	"log"
 	"os"
 
-	"github.com/sendgrid/sendgrid-go"
+	"github.com/sendgrid/sendgrid-go/v3"
 )
 
 // CreateabatchID : Create a batch ID

diff --git a/examples/mailboxproviders/mailboxproviders.go b/examples/mailboxproviders/mailboxproviders.go
@@ -5,7 +5,7 @@ import (
 	"log"
 	"os"
 
-	"github.com/sendgrid/sendgrid-go"
+	"github.com/sendgrid/sendgrid-go/v3"
 )
 
 // Retrieveemailstatisticsbymailboxprovider : Retrieve email statistics by mailbox provider.

diff --git a/examples/mailsettings/mailsettings.go b/examples/mailsettings/mailsettings.go
@@ -5,7 +5,7 @@ import (
 	"log"
 	"os"
 
-	"github.com/sendgrid/sendgrid-go"
+	"github.com/sendgrid/sendgrid-go/v3"
 )
 
 // Retrieveallmailsettings : Retrieve all mail settings

diff --git a/examples/partnersettings/partnersettings.go b/examples/partnersettings/partnersettings.go
@@ -5,7 +5,7 @@ import (
 	"log"
 	"os"
 
-	"github.com/sendgrid/sendgrid-go"
+	"github.com/sendgrid/sendgrid-go/v3"
 )
 
 // Returnsalistofallpartnersettings : Returns a list of all partner settings.

diff --git a/examples/scopes/scopes.go b/examples/scopes/scopes.go
@@ -5,7 +5,7 @@ import (
 	"log"
 	"os"
 
-	"github.com/sendgrid/sendgrid-go"
+	"github.com/sendgrid/sendgrid-go/v3"
 )
 
 // Retrievealistofscopesforwhichthisuserhasaccess : Retrieve a list of scopes for which this user has access.

diff --git a/examples/senderauthentication/senderauthentication.go b/examples/senderauthentication/senderauthentication.go
@@ -5,7 +5,7 @@ import (
 	"log"
 	"os"
 
-	"github.com/sendgrid/sendgrid-go"
+	"github.com/sendgrid/sendgrid-go/v3"
 )
 
 // Createadomainauthentication : Create a domain authentication.

diff --git a/examples/senders/senders.go b/examples/senders/senders.go
@@ -5,7 +5,7 @@ import (
 	"log"
 	"os"
 
-	"github.com/sendgrid/sendgrid-go"
+	"github.com/sendgrid/sendgrid-go/v3"
 )
 
 // CreateaSenderIdentity : Create a Sender Identity

diff --git a/examples/stats/stats.go b/examples/stats/stats.go
@@ -5,7 +5,7 @@ import (
 	"log"
 	"os"
 
-	"github.com/sendgrid/sendgrid-go"
+	"github.com/sendgrid/sendgrid-go/v3"
 )
 
 // Retrieveglobalemailstatistics : Retrieve global email statistics

diff --git a/examples/subusers/subusers.go b/examples/subusers/subusers.go
@@ -5,7 +5,7 @@ import (
 	"log"
 	"os"
 
-	"github.com/sendgrid/sendgrid-go"
+	"github.com/sendgrid/sendgrid-go/v3"
 )
 
 // CreateSubuser : Creates a Subuser

diff --git a/examples/suppression/suppression.go b/examples/suppression/suppression.go
@@ -5,7 +5,7 @@ import (
 	"log"
 	"os"
 
-	"github.com/sendgrid/sendgrid-go"
+	"github.com/sendgrid/sendgrid-go/v3"
 )
 
 // Retrieveallblocks : Retrieve all blocks

diff --git a/examples/templates/templates.go b/examples/templates/templates.go
@@ -5,7 +5,7 @@ import (
 	"log"
 	"os"
 
-	sendgrid "github.com/sendgrid/sendgrid-go"
+	sendgrid "github.com/sendgrid/sendgrid-go/v3"
 )
 
 // Createatransactionaltemplate : Create a transactional template.