Email API & Integration

curl -XPOST \

https://api.sparkpost.com/api/v1/transmissions \

-H "Authorization: <YOUR API KEY>" \

-H "Content-Type: application/json" \

-d '{"options": {"sandbox": true}, "content": {"from": "testing@sparkpostbox.com", "subject": "Oh hey", "text":"Testing SparkPost - the most awesomest email service in the world"}, "recipients": [{"address": "developers+curl@sparkpost.com"}]}'

const SparkPost = require('sparkpost');

const sparky = new SparkPost('<YOUR API KEY>');

sparky.transmissions.send({

options: {

sandbox: true

content: {

from: 'testing@sparkpostbox.com',

subject: 'Oh hey!',

html:'<html><body>Testing SparkPost - the world\'s most awesomest email service!</body></html>'

recipients: [

{address: 'developers+nodejs@sparkpost.com'}

]

})

.then(data => {

console.log('Woohoo! You just sent your first mailing!');

console.log(data);

})

.catch(err => {

console.log('Whoops! Something went wrong');

console.log(err);

});

View on Github

from sparkpost import SparkPost

sparky = SparkPost('<YOUR API KEY>')

response = sparky.transmissions.send(

use_sandbox=True,

recipients=['developers+python@sparkpost.com'],

html='<html><body>Testing SparkPost - the world\'s most awesomest email service!</body></html>',

from_email='testing@sparkpostbox.com',

subject='Oh hey!')

View on Github

<?php

use SparkPost\SparkPost;

use GuzzleHttp\Client;

use Http\Adapter\Guzzle6\Client as GuzzleAdapter;

$httpClient = new GuzzleAdapter(new Client());

$sparky = new SparkPost($httpClient, ['key' => '<YOUR API KEY>']);

$sparky->setOptions(['async' => false]);

$results = $sparky->transmissions->post([

'options' => [

'sandbox' => true

'content' => [

'from' => 'testing@sparkpostbox.com',

'subject' => 'Oh hey!',

'html' => '<html><body>Testing SparkPost - the world\'s most awesomest email service!</body></html>'

'recipients' => [

['address' => ['email'=>'developers+php@sparkpost.com']]

]

]);

View on Github

package com.sparkpost;

import com.sparkpost.exception.SparkPostException;

public class SparkPost {

public static void main(String[] args) throws SparkPostException {

String API_KEY = "<YOUR API KEY>";

Client sparky = new Client(API_KEY);

sparky.sendMessage(

"testing@sparkpostbox.com",

"developers+java@sparkpost.com",

"Oh hey!",

"Testing SparkPost - the world's most awesomest email service!",

"Testing SparkPost - the world's most awesomest email service!");

}

View on Github

var transmission = new Transmission();

transmission.Content.From.Email = "testing@sparkpostbox.com";

transmission.Content.Subject = "Oh hey!";

transmission.Content.Text = "Testing SparkPost - the world\'s most awesomest email service!";

transmission.Content.Html = "<html><body>Testing SparkPost - the world\'s most awesomest email service!</body></html>";

var recipient = new Recipient

{

Address = new Address { Email = "my@email.com" }

};

transmission.Recipients.Add(recipient);

var client = new Client("<YOUR API KEY>");

client.Transmissions.Send(transmission);

// or client.Transmissions.Send(transmission).Wait();

package main

import (

sp "github.com/SparkPost/gosparkpost"

"log"

)

func main() {

var sparky sp.Client

err := sparky.Init(&sp.Config{ApiKey: "<YOUR API KEY>"})

if err != nil {

log.Fatalf("SparkPost client init failed: %s\n", err)

}

tx := &sp.Transmission{

Recipients: []string{"developers+go@sparkpost.com"},

Options: &sp.TxOptions{Sandbox: true},

Content: sp.Content{

HTML: "Testing SparkPost - the world's most awesomest email service!",

From: "test@sparkpostbox.com",

Subject: "Oh hey!",

}

id, _, err := sparky.Send(tx)

if err != nil {

log.Fatal(err)

}

log.Printf("Transmission sent with id [%s]\n", id)

}

View on Github

alias SparkPost.{Content, Transmission}

defmodule MyApp do

def main(args) do

Transmission.send(%Transmission{

recipients: ["developers+elixir@sparkpost.com"],

content: %Content.Inline{

from: "test@sparkpostbox.com",

subject: "Oh hey!",

html: "Testing SparkPost - the world's most awesomest email service!",

options: %Transmission.Options{sandbox: true}

})

end

View on Github

Painless SMTP & API Integration for Developers at Companies of All Sizes

There’s never been a better way to build email into an app or service and to feed performance data back into other systems. Whether you’re looking for an email API or SMTP, we’ve got you covered. Get email integration set up fast—and set up right.

Email your way is just minutes away

SparkPost helps developers hit the ground running when it comes to work with email:

Onboarding workflow makes it easy to create an account, configure a domain, and get up and running in minutes.
Already sending with SMTP? It only takes a few configuration settings to start sending with SparkPost.

Build email into any app with SparkPost’s killer email API

We’re not kidding when we say SparkPost is API-driven email delivery. We’re builders like you, and SparkPost’s REST email API makes it easy to embed transactional email and analytics into any app or workflow.

SparkPost’s REST API gives control of every SparkPost message generation feature: manipulating templates, generating messages, sending emails, and reporting performance data.
Performance data is fully queryable, and the SparkPost API gives programmatic access to summary data as well as details of individual email messages.
API-driven and API-first. The SparkPost web app itself is built on our API.

Powerful SMTP injection made easy

SMTP injection is an easy way to get started, but don’t let that simplicity fool you. This service is no dumb SMTP relay. SparkPost’s SMTP support is powerful.

Personalize messages during SMTP injection.
Generate unique tracking data for every SMTP message.
Nearly every API feature can be invoked with an SMTP X-Header.

Work with our API, whatever your language

We work the way you work. Our client libraries allow you to use SparkPost with the language of your choice. Be productive with your language and your team’s skills.

Client libraries for Node.js, PHP. Python, Java, Go, and many more.
SparkPost and developer community contributions on GitHub.

Push real-time activity with webhooks

SparkPost’s webhooks (HTTP callbacks) capability pushes every detail of inbound or outbound message activity as it happens, delivering you a rich stream of structured data. With our webhooks, your ability to tie email sending and receiving into other systems, apps, sites, and processes in real time is virtually unlimited.

Stream JSON data about message activity to your endpoint as it happens.
Enable inbound message handling, from simple relaying to complex programmatic processing.
Trigger actions in your apps and business processes in real time with webhooks for outbound and inbound messages.

Pre-built integration with key cloud platforms

If you’re building in the cloud, SparkPost’s pre-built integrations make it easy to configure and use SparkPost with other services.

Major cloud infrastructure providers like Heroku and Microsoft Azure.
Marketing and other business systems.
Web service connectors like Zapier.
And literally dozens more.

Email integration support for enterprise senders

Whether you’re building a new service or orchestrating a long-running business process, enterprises that need to integrate email with complex business systems need rock-solid email integration. Customers who choose our Premium and Enterprise add-on plans can count on the support of our Technical Account Managers (TAMs) to deliver technical excellence with a savvy understanding of business needs.

Learn More about Email API and Integration

Build email development skills and explore email best practices with SparkPost’s email API and developer resources.

Developer Hub API Docs

From endpoints and authentication to using Postman and cURL, everything you need to know about working with SparkPost API.

Creating API Keys

Step-by-step instructions for setting up a valid SparkPost API key to use SparkPost REST APIs or SMTP injection.

SMTP Set-Up Video Walkthrough

Here’s a short video walkthrough on how to use SparkPost as a SMTP relay with a typical newsletter app.

Email API & Integration

With our email API and SMTP integration, connecting email to your app has never been easier

Painless SMTP & API Integration for Developers at Companies of All Sizes

Email your way is just minutes away

Build email into any app with SparkPost’s killer email API

Powerful SMTP injection made easy

Work with our API, whatever your language

Push real-time activity with webhooks

Pre-built integration with key cloud platforms

Email integration support for enterprise senders

Learn More about Email API and Integration

Developer Hub API Docs

Creating API Keys

SMTP Set-Up Video Walkthrough

Start sending email in minutes!