sendgrid 2.2.1

SendGrid library for Python

This library allows you to quickly and easily use the SendGrid Web API via Python.

Currently this library supports our v2 Mail endpoint and the v3 Web API.

Installation

pip install sendgrid

or

easy_install sendgrid

Dependencies

• The SendGrid Service, starting at the free level

• SMTAPI-Python

• Python-HTTP-Client

Environment Variables (for v3 Web API)

Sample .env, please rename to .env and add your SendGrid API Key, or you can pass your API Key into the SendGridClient constructor.

Quick Start

v2 Mail Send endpoint (Send an Email)

import sendgrid

sg = sendgrid.SendGridClient('YOUR_SENDGRID_API_KEY')


message = sendgrid.Mail()
message.add_to('John Doe <[e-mail]>')
message.set_subject('Example')
message.set_html('Body')
message.set_text('Body')
message.set_from('Doe John <[e-mail]>')
status, msg = sg.send(message)
print(status, msg)

#or

message = sendgrid.Mail(to='[e-mail]', subject='Example', html='Body', text='Body', from_email='[e-mail]')
status, msg = sg.send(message)
print(status, msg)

v3 Web API endpoints

import sendgrid

sg = sendgrid.SendGridAPIClient(apikey='YOUR_SENDGRID_API_KEY')
# You can also store your API key an .env variable 'SENDGRID_API_KEY'

response = sg.client.api_keys.get()
print(response.status_code)
print(response.response_body)
print(response.response_headers)

Announcements

BREAKING CHANGE as of 2016.03.01

Version 2.0.0 is a breaking change for the Web API v3 endpoints. The mail send endpoint is not affected by this update.

Version 2.0.0 brings you full support for all Web API v3 endpoints. We have the following resources to get you started quickly:

• SendGrid Documentation

• Usage Documentation

• Example Code

Thank you for your continued support!

For the v2 Mail Send Endpoint, if you upgrade to version 1.2.x, the add_to method behaves differently. In the past this method defaulted to using the SMTPAPI header. Now you must explicitly call the smtpapi.add_to method. More on the SMTPAPI section.

Roadmap

Milestones

How to Contribute

We encourage contribution to our libraries, please see our CONTRIBUTING guide for details.

• Feature Request

• Bug Reports

• Improvements to the Codebase

Usage

• SendGrid Docs

• v2 Mail Send

• v3 Web API

• Example Code

Unsupported Libraries

• Official and Unsupported SendGrid Libraries

About

sendgrid-python is guided and supported by the SendGrid Developer Experience Team.

sendgrid-python is maintained and funded by SendGrid, Inc. The names and logos for sendgrid-python are trademarks of SendGrid, Inc.