Stitch Documentation
has moved!

Please update your bookmarks to

If you're not automatically redirected after 5 seconds, click here.

Connecting SparkPost

Heads Up!

Connecting SparkPost to Stitch is a three-step process:

  1. Add SparkPost as a Stitch data source
  2. Generate a Webhook URL
  3. Set up webhooks in SparkPost

SparkPost Webhook Limits

Before you dive into connecting SparkPost to Stitch, take note of the following:

  1. SparkPost allows a user to create up to 20 webhooks.
  2. A SparkPost webhook may be triggered up to 10 times per minute for every device registered to that user’s account.

Adding SparkPost as a Stitch Data Source

  1. On the Stitch Dashboard page, click the Add an Integration button.
  2. Click the SparkPost icon.
  3. Enter a name for the integration. This is the name that will display on the Stitch Dashboard for the integration; it’ll also be used to create the schema in your data warehouse.

    For example, the name “Stitch SparkPost" would create a schema called stitch_sparkpost in the data warehouse. This schema is where all the tables for this integration will be stored.
  4. Click Save Integration.

Generating a SparkPost Webhook URL

Once Stitch has successfully saved and created the integration, you’ll be redirected to a page that displays your webhook URL and token (which is blurred in the image below):

Stitch Webhook URL

Click the Copy button to copy it.

Note that this particular URL won’t display in Stitch again once you click Continue. Think of this URL like you would your login or API credentials - keep it secret, keep it safe. You can, however, generate another URL should you need it.

Once you’ve copied your webhook URL, click Continue to wrap things up in Stitch.

Setting Up Webhooks in SparkPost

The last step is to setup webhooks in your SparkPost account.

  1. Sign into your SparkPost account.
  2. Click Account in the left nav tab.
  3. Click Webhooks.
  4. Click the New Webhook button.
  5. In the Webhook Name field, enter a name for the webhook. We recommend using a name that will tell you, at a glance, what the webhook is for.
  6. In the Target URL field, paste your Stitch-generated webhook URL.
  7. In the Authentication field, ensure that None is selected.
  8. In the Events section, you can select the events you want to track. By default everything is selected, but to pick and choose, click Select and then use the checkboxes to select the events you want:

  9. When finished, click Add Webhook.

Testing the Setup

To ensure everything is set up properly, you can send a test call to your Stitch webhook by clicking the Test button next to the Stitch webhook and then clicking Send Test Batch:

If you encounter a 5xx error (ex: 503 - Service Unavailable), check the Stitch Status Page to see if we’ve reported any issues.

SparkPost Data & Replication

After the setup for SparkPost is complete, your webhook data will be continuously replicated through Stitch. To learn more about how Stitch replicates SparkPost webhook data and our recommended strategy for querying, check out the Expected SparkPost Data article.


Was this article helpful?
0 out of 0 found this helpful


Questions or suggestions? If something in our documentation is unclear, let us know in the comments!