Skip to content
SendGrid's smtpapi library in PHP
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
examples Updating to comply with SendGrid's new open source policies May 18, 2016
lib Version Bump v0.6.1: #27 Remove Swift Mailer as a dependency Jul 6, 2017
scripts Normalize project file using PHP-FIG convention Mar 26, 2015
test Fix casing issue Oct 7, 2018
.editorconfig Normalize project file using PHP-FIG convention Mar 26, 2015
.env_sample edit .env_sample Oct 27, 2017
.travis.yml Add Code Reviews to Oct 31, 2017
LICENSE.txt Added missing '>' in SetTos usage example. Oct 28, 2017
composer.json Update composer.json Oct 13, 2018
composer.lock Fixed lock file with 5.6 versions Oct 6, 2018

SendGrid Logo

BuildStatus Latest Stable Version Latest Version on Packagist Email Notifications Badge Twitter Follow GitHub contributors MIT licensed

This module helps build SendGrid's SMTP API headers.

Learn more about the SMTP API at SendGrid's documentation.


All updates to this module is documented in our CHANGELOG.

Table of Contents



  • PHP version 5.6 or 7.0
  • The SendGrid service, starting at the free level

Install with Composer

The following recommended installation requires

Add the following to your composer.json file.

    "require": {
        "sendgrid/smtpapi": "~0.6@dev"

Then at the top of your script require the autoloader:

require 'vendor/autoload.php';

Alternative: Install from zip

If you are not using Composer, simply download and install the latest packaged release of the library as a zip.

Then require the library from package:


Previous versions of the library can be found in the version index.

Setup Environment Variables

Environment Variable

Update the development environment with your SENDGRID_API_KEY, for example:

echo "export SENDGRID_API_KEY='YOUR_API_KEY'" > sendgrid.env
echo "sendgrid.env" >> .gitignore
source ./sendgrid.env

Quick Start

$header = new Smtpapi\Header();
print $header->jsonString();



If you are interested in the future direction of this project, please take a look at our milestones. We would love to hear your feedback.

How to Contribute

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

Quick links:


smtpapi-php is guided and supported by the SendGrid Developer Experience Team.

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


The MIT License (MIT)

You can’t perform that action at this time.